@nocobase/app-plugin-agents 0.1.0-beta.11 → 0.1.0-beta.13

package/dist/server/routes/schemas.js

@@ -2,8 +2,10 @@
  * The path parameters, query strings and small bodies of the plugin's routes. Bodies the services own (an agent, a
  * skill, a model service) keep their schemas beside the service, strict there too.
  */
+import { RUNNER_LIST_FIELDS } from '../../shared/runners.js';
 import { ACTOR_KINDS, AGENT_TOOLS, AgentToolSchema, FailureReasonSchema, PERMISSION_MODES, RUN_INPUT_TYPES, RUN_EVENT_TYPES, RUN_STATUSES, RunEventSchema, RunnerFeatureSchema, RunnerPolicySchema, RunStatusSchema, ToolInfoSchema, ToolLoadSchema, ToolSlotsSchema, WorkspaceDecisionSchema, WorkspaceCleanupResultSchema, } from '@nocobase/agent-protocol';
 import { z } from 'zod';
+import { QuotaReportSchema } from '@nocobase/agent-protocol';
 import { AGENT_CHANGE_ACTIONS, AGENT_SOURCES, AGENT_STATUSES, AGENT_UNUSABLE_REASONS, CONFIRM_CHANGES, } from '../../shared/agents.js';
 import { CONSULTATION_STATES, CONVERSATION_SOURCE_PATTERN, MESSAGE_ROLES, OFFLINE_REASONS, TITLE_SOURCES, } from '../../shared/conversations.js';
 import { MODEL_KINDS, MODEL_PROVIDER_NAMES, } from '../../shared/models.js';
@@ -20,39 +22,83 @@ const pageToken = z.string().min(1).max(2000).optional();
 function pageSize(fallback, max) {
     return z.coerce.number().int().min(1).max(max).default(fallback);
 }
+export const QuotaLocationSchema = z
+    .object({
+    runnerId: z.string().describe('The visible runtime with the quota mark.'),
+    runnerName: z.string().describe('The runtime display name.'),
+    resetsAt: z
+        .string()
+        .nullable()
+        .describe('The known reset time, or null for an unknown reset.'),
+})
+    .meta({
+    ref: 'AgentsQuotaLocation',
+    description: 'A runtime whose quota blocks this agent for the viewer.',
+});
 export const AgentParams = z.object({
-    agentId: id,
+    agentId: id.describe('The agent identifier.'),
 });
 export const RunParams = z.object({
-    runId: id,
+    runId: id.describe('The run identifier.'),
 });
 export const SkillParams = z.object({
-    skillId: id,
+    skillId: id.describe('The skill identifier.'),
 });
-export const SkillVersionParams = z.object({ skillId: id, version: z.coerce.number().int().min(1) });
-export const ScopeParams = z.object({ scopeKind: id, scopeId: id });
-export const VariableParams = z.object({ scopeKind: id, scopeId: id, variableName: id });
-export const WorkspaceParams = z.object({ subjectKind: id, subjectId: id });
-export const ConversationParams = z.object({ conversationId: id });
+export const SkillVersionParams = z.object({
+    skillId: id.describe('The skill identifier.'),
+    version: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .describe('The version to read or restore.'),
+});
+export const ScopeParams = z.object({ scopeKind: id, scopeId: id.describe('The scope identifier.') });
+export const VariableParams = z.object({
+    scopeKind: id,
+    scopeId: id.describe('The scope identifier.'),
+    variableName: id.describe('The variable name.'),
+});
+export const WorkspaceParams = z.object({
+    subjectKind: id.describe('The kind of subject.'),
+    subjectId: id.describe('The subject identifier.'),
+});
+export const ConversationParams = z.object({ conversationId: id.describe('The conversation identifier.') });
 export const ServiceParams = z.object({
-    serviceName: id,
+    serviceName: id.describe('The configured model service name.'),
 });
 export const RunnerParams = z.object({
-    runnerId: id,
+    runnerId: id.describe('The runner identifier.'),
+});
+export const JobParams = z.object({
+    jobId: id.describe('The job identifier.'),
+});
+export const RunSkillParams = z.object({
+    runId: id.describe('The run identifier.'),
+    slug: id.describe('The document’s stable URL slug.'),
+});
+export const RunMountParams = z.object({
+    runId: id.describe('The run identifier.'),
+    name: id.describe('The name to display.'),
 });
-export const JobParams = z.object({ jobId: id });
-export const RunSkillParams = z.object({ runId: id, slug: id });
-export const RunMountParams = z.object({ runId: id, name: id });
 export const CommandParams = z.object({
-    commandId: id,
+    commandId: id.describe('The command identifier.'),
 });
 export const DistTargetParams = z.object({ product: id, target: id });
-export const DistFileParams = z.object({ product: id, version: id, file: id });
+export const DistFileParams = z.object({
+    product: id,
+    version: id.describe('The version to read or restore.'),
+    file: id.describe('The file to upload.'),
+});
 export const AgentListQuery = z.object({ includeArchived: queryBoolean.optional() });
 export const AgentHistoryQuery = z.object({
-    afterRevision: z.coerce.number().int().min(0).optional(),
-    pageSize: pageSize(50, 100),
-    pageToken,
+    afterRevision: z.coerce
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Return history after this revision.'),
+    pageSize: pageSize(50, 100).describe('The maximum number of records to return.'),
+    pageToken: pageToken.describe('The continuation token returned by the previous page.'),
 });
 export const PreviewBriefQuery = z.object({
     scenario: id.optional().meta({
@@ -60,23 +106,31 @@ export const PreviewBriefQuery = z.object({
     }),
 });
 export const AuditListQuery = z.object({
-    pageSize: pageSize(50, 100),
-    pageToken,
+    pageSize: pageSize(50, 100).describe('The maximum number of records to return.'),
+    pageToken: pageToken.describe('The continuation token returned by the previous page.'),
 });
 export const RunListQuery = z.object({
-    subjectKind: id.optional(),
-    subjectId: id.optional(),
-    agentId: id.optional(),
-    status: z.enum(RUN_STATUSES).optional(),
-    pageSize: pageSize(50, 100),
-    pageToken,
+    subjectKind: id.optional().describe('The kind of subject.'),
+    subjectId: id.optional().describe('The subject identifier.'),
+    agentId: id.optional().describe('The agent identifier.'),
+    status: z
+        .enum(RUN_STATUSES)
+        .optional()
+        .describe('The status to set or filter by.'),
+    pageSize: pageSize(50, 100).describe('The maximum number of records to return.'),
+    pageToken: pageToken.describe('The continuation token returned by the previous page.'),
 });
 /**
  * A run's transcript after `after` (a `seq`). The run panel reads a transcript whole, so a page holds up to 1000
  * events, beyond the usual cap of 100.
  */
 export const RunEventsQuery = z.object({
-    after: z.coerce.number().int().min(0).optional(),
+    after: z.coerce
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Return messages after this cursor.'),
     // Hono represents one query value as a string and repeated values as an array.
     type: z
         .preprocess((value) => (typeof value === 'string' ? [value] : value), z.array(z.enum(RUN_EVENT_TYPES)).min(1).max(100))
@@ -86,40 +140,78 @@ export const RunEventsQuery = z.object({
         items: { type: 'string', enum: [...RUN_EVENT_TYPES] },
         description: 'Only these raw event types (repeat for more). Omit to read every type.',
     }),
-    pageSize: pageSize(500, 1000),
-    pageToken,
+    pageSize: pageSize(500, 1000).describe('The maximum number of records to return.'),
+    pageToken: pageToken.describe('The continuation token returned by the previous page.'),
 });
 export const UsageQuerySchema = z.object({
-    from: z.string().min(1).max(40).optional(),
-    to: z.string().min(1).max(40).optional(),
-    groupBy: z.enum(USAGE_GROUP_BYS).default('agent'),
-    groupId: id.optional(),
-    agentId: id.optional(),
-    userId: id.optional(),
+    from: z
+        .string()
+        .min(1)
+        .max(40)
+        .optional()
+        .describe('The beginning of the reporting period.'),
+    to: z
+        .string()
+        .min(1)
+        .max(40)
+        .optional()
+        .describe('The end of the reporting period.'),
+    groupBy: z
+        .enum(USAGE_GROUP_BYS)
+        .default('agent')
+        .describe('The dimension to group usage by.'),
+    groupId: id.optional().describe('The group identifier.'),
+    agentId: id.optional().describe('The agent identifier.'),
+    userId: id.optional().describe('The user identifier.'),
     series: queryBoolean.optional().meta({
         description: 'Also break each day of `daily` down by the `groupBy` key (`daily[].series`).',
     }),
 });
 export const ModelUsageQuery = z.object({
-    from: z.string().min(1).max(40).optional(),
-    to: z.string().min(1).max(40).optional(),
+    from: z
+        .string()
+        .min(1)
+        .max(40)
+        .optional()
+        .describe('The beginning of the reporting period.'),
+    to: z
+        .string()
+        .min(1)
+        .max(40)
+        .optional()
+        .describe('The end of the reporting period.'),
 });
 export const ConversationListQuerySchema = z.object({
-    q: z.string().max(200).optional(),
-    archived: z.enum(['true', 'false', 'all']).optional(),
-    agentId: id.optional(),
-    source: z.string().regex(CONVERSATION_SOURCE_PATTERN).optional(),
-    pageSize: pageSize(30, 100),
-    pageToken,
+    q: z.string().max(200).optional().describe('Text to search for.'),
+    archived: z
+        .enum(['true', 'false', 'all'])
+        .optional()
+        .describe('Filter by archive state.'),
+    agentId: id.optional().describe('The agent identifier.'),
+    source: z
+        .string()
+        .regex(CONVERSATION_SOURCE_PATTERN)
+        .optional()
+        .describe('The source context associated with this record.'),
+    pageSize: pageSize(30, 100).describe('The maximum number of records to return.'),
+    pageToken: pageToken.describe('The continuation token returned by the previous page.'),
 });
 /** Messages, newest page first; `after` reads what arrived since a `seq`. Up to 200 for a whole short chat. */
 export const MessageListQuerySchema = z.object({
-    after: z.coerce.number().int().min(0).optional(),
-    pageSize: pageSize(50, 200),
-    pageToken,
+    after: z.coerce
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Return messages after this cursor.'),
+    pageSize: pageSize(50, 200).describe('The maximum number of records to return.'),
+    pageToken: pageToken.describe('The continuation token returned by the previous page.'),
 });
 export const ModelCatalogQuery = z.object({
-    kind: z.enum(MODEL_KINDS).default('chat'),
+    kind: z
+        .enum(MODEL_KINDS)
+        .default('chat')
+        .describe('The model capability: chat, embedding, or rerank.'),
 });
 export const ClaimQuery = z.object({
     wait: queryBoolean.optional(),
@@ -141,27 +233,43 @@ export const VariableValueInput = z.strictObject({
         description: 'Take it from the runner: no value is kept here, and the runner that takes the run provides it (`nocobase-runner env set NAME`, or `--pass-env NAME`). Leave `value` out.',
     }),
 });
-export const SkillRestoreInput = z.strictObject({ expectedRevision: z.number().int().min(1) });
+export const SkillRestoreInput = z.strictObject({
+    expectedRevision: z
+        .number()
+        .int()
+        .min(1)
+        .describe('The revision last read; reject if the record has changed.'),
+});
 export const RunnerPatchInput = z
     .strictObject({
-    name: z.string().trim().min(1).max(200),
-    trust: z.enum(RUNNER_TRUST),
-    slots: z.number().int().min(1).max(64),
+    name: z.string().trim().min(1).max(200).describe('The name to display.'),
+    trust: z.enum(RUNNER_TRUST).describe('The runner trust level.'),
+    slots: z
+        .number()
+        .int()
+        .min(1)
+        .max(64)
+        .describe('The maximum number of concurrent runs.'),
     toolSlots: ToolSlotsSchema.nullable().meta({
         description: 'How many runs of each coding tool it may hold at once, beside `slots`; null, or a tool left out, for no limit of its own.',
     }),
-    enabledTools: z.array(AgentToolSchema).max(AGENT_TOOLS.length).nullable(),
-    acceptJobs: z.boolean(),
+    enabledTools: z
+        .array(AgentToolSchema)
+        .max(AGENT_TOOLS.length)
+        .nullable()
+        .describe('The agent tools this runner accepts.'),
+    acceptJobs: z.boolean().describe('Whether the runner accepts new work.'),
 })
     .partial();
 export const RegistrationTokenInputSchema = z.strictObject({
-    trust: z.enum(RUNNER_TRUST).optional(),
+    trust: z.enum(RUNNER_TRUST).optional().describe('The runner trust level.'),
     enabledTools: z
         .array(AgentToolSchema)
         .min(1)
         .max(AGENT_TOOLS.length)
         .nullable()
-        .optional(),
+        .optional()
+        .describe('The agent tools this runner accepts.'),
     slots: z.number().int().min(1).max(64).nullable().optional().meta({
         description: "How many runs at once the runner takes; omitted or null leaves it to the runner. A runner's own `--slots` overrides it.",
     }),
@@ -287,6 +395,10 @@ export const AgentViewSchema = agentObject
         .meta({
         description: 'The online runners that have its tool and model: team ones, personal ones, the caller’s own, and a few names.',
     }),
+    quota: z
+        .array(QuotaLocationSchema)
+        .optional()
+        .describe('Viewer-visible runtime quota blocks; an empty list means no quota block.'),
     personalOnly: z.boolean().meta({
         description: 'Only personal runners have it.',
     }),
@@ -317,6 +429,10 @@ export const AvailableAgentSchema = z
     online: z.boolean().meta({
         description: 'Whether a runner would take the caller’s work now.',
     }),
+    quota: z
+        .array(QuotaLocationSchema)
+        .optional()
+        .describe('Viewer-visible runtime quota blocks; an empty list means no quota block.'),
     personalOnly: z.boolean().meta({
         description: 'Only personal runners have it.',
     }),
@@ -493,6 +609,7 @@ const skillDetailObject = skillObject.extend({
         scope: z.string(),
         scopeId: z.string(),
         name: z.string().nullable(),
+        href: z.string().optional(),
     })),
 });
 export const SkillDetailSchema = skillDetailObject;
@@ -547,6 +664,7 @@ const RunEffortReportSchema = z
     .meta({ ref: 'AgentsRunEffortReport' });
 export const RunExecutionSnapshotSchema = z
     .object({
+    quota: QuotaReportSchema.optional(),
     selection: z
         .object({
         reason: z.enum(['preferredQueued', 'preferredUnavailable']),
@@ -577,6 +695,9 @@ export const RunExecutionSnapshotSchema = z
     dispatchedAt: dateTime,
     finishedAt: dateTime.nullable(),
     failureReason: z.string().nullable(),
+    failureSource: z.literal('sweeper').optional().meta({
+        description: 'The server reclaimed this pre-start attempt; absent on runner-reported failures.',
+    }),
 })
     .meta({ ref: 'AgentsRunExecutionSnapshot' });
 const runObject = z.object({
@@ -992,7 +1113,7 @@ export const ChatAttachmentContentQuery = z.object({
         .transform((value) => value === 'true')
         .meta({ description: '`true` to save the file rather than show it.' }),
 });
-export const ChatAttachmentParams = z.object({ attachmentId: id });
+export const ChatAttachmentParams = z.object({ attachmentId: id.describe('The attachment identifier.') });
 const messageObject = z.object({
     id: z.string(),
     conversationId: z.string(),
@@ -1048,6 +1169,9 @@ export const SendMessageResultSchema = z
 })
     .meta({ ref: 'AgentsSendMessageResult' });
 export const ChatAgentSchema = z.object({
+    runnerNames: z
+        .array(z.string())
+        .describe('Eligible runtime display names visible to this caller.'),
     id: z.string(),
     name: z.string(),
     description: z.string().nullable(),
@@ -1056,6 +1180,7 @@ export const ChatAgentSchema = z.object({
     avatar: z.string().nullable(),
     isSystemDefault: z.boolean(),
     isMyDefault: z.boolean(),
+    quota: z.array(QuotaLocationSchema).optional(),
     availability,
     personalOnly: z.boolean().meta({
         description: 'Only personal runners have it.',
@@ -1070,7 +1195,7 @@ export const ChatSettingsSchema = z.object({
     }),
 });
 // A runner's working directories, as it last reported them.
-const RunnerWorkspaceSchema = z.object({
+export const RunnerWorkspaceSchema = z.object({
     subjectKey: z.string().optional(),
     sizeBytes: z.number().int().nonnegative().optional(),
     decision: WorkspaceDecisionSchema.optional(),
@@ -1105,6 +1230,25 @@ const RunnerWorkspaceUsageSchema = z
         description: "The disk holding the runner's working directories; null when it did not say.",
     }),
     intervalMs: z.number().int().positive().optional(),
+    totalBytes: z
+        .number()
+        .nonnegative()
+        .optional()
+        .describe('Sum of measured directory sizes in bytes.'),
+    sizeUnknownCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Directories without a measured size.'),
+    counts: z
+        .object({
+        all: z.number().int(),
+        active: z.number().int(),
+        retained: z.number().int(),
+        ended: z.number().int(),
+    })
+        .optional(),
     count: z.number().int(),
     unpushedCount: z.number().int(),
     measuredAt: dateTime.nullable(),
@@ -1151,6 +1295,68 @@ const runnerObject = z.object({
     variables: z.array(z.string()).nullable().optional().meta({
         description: 'The names of the variables it provides to runs that take them from the runner, as it last reported them; null when it reported none. Names only.',
     }),
+    quotaRevision: z
+        .number()
+        .int()
+        .describe('The server quota-state revision; clearing does not require it.'),
+    quotaUsage: z
+        .array(z.object({
+        tool: AgentToolSchema.describe('The coding tool whose quota was observed.'),
+        window: z
+            .string()
+            .describe('The tool-reported usage window identifier.'),
+        scope: z
+            .enum(['tool', 'provider', 'model'])
+            .describe('The affected quota scope.'),
+        target: z
+            .string()
+            .describe('Provider or model identifier; empty for the whole tool.'),
+        usedPercent: z
+            .number()
+            .optional()
+            .describe('Observed usage percentage, when the tool reports it.'),
+        resetsAt: z
+            .string()
+            .nullable()
+            .describe('Known reset instant; null means manual recovery.'),
+        observedAt: z
+            .string()
+            .describe('When the usage snapshot was accepted.'),
+        exhausted: z
+            .boolean()
+            .optional()
+            .describe('Whether the observed window was exhausted.'),
+    }))
+        .nullable()
+        .optional()
+        .describe('Throttled usage snapshots, persisted at five-point changes or state transitions.'),
+    unavailableModels: z
+        .array(z.object({
+        tool: AgentToolSchema.describe('The coding tool whose quota was observed.'),
+        model: z
+            .string()
+            .describe('Affected model or provider; empty for a tool-wide mark.'),
+        at: z.string().describe('When the unavailable mark was observed.'),
+        reported: z
+            .array(z.string())
+            .describe('Models reported by the tool when the mark was recorded.'),
+        reason: z
+            .enum(['modelUnavailable', 'toolQuota'])
+            .optional()
+            .describe('The reason this scope cannot accept work.'),
+        scope: z
+            .enum(['tool', 'provider', 'model'])
+            .optional()
+            .describe('The marked scope; legacy marks target one model.'),
+        window: z.string().optional().describe('The exhausted usage window.'),
+        resetsAt: z
+            .string()
+            .nullable()
+            .optional()
+            .describe('Automatic recovery instant; absent or null means unknown.'),
+    }))
+        .nullable()
+        .optional(),
     workspaceUsage: RunnerWorkspaceUsageSchema.nullable().optional().meta({
         description: 'The working directories it keeps for this application and the free space on the disk holding them, as it last reported them; null or absent before it reports.',
     }),
@@ -1158,10 +1364,11 @@ const runnerObject = z.object({
     createdAt: dateTime,
     updatedAt: dateTime,
 });
-export const RunnerSchema = runnerObject.meta({
+export const RunnerSchema = runnerObject.omit({ quotaRevision: true }).meta({
     ref: 'AgentsRunner',
 });
-export const RunnerSummarySchema = runnerObject
+const runnerSummaryObject = runnerObject
+    .omit({ quotaRevision: true })
     .extend({
     hostname: z.string().nullable().meta({
         description: 'The host name it reported; null for a caller who may not manage it.',
@@ -1179,6 +1386,14 @@ export const RunnerSummarySchema = runnerObject
     canManage: z.boolean(),
     canChangeTrust: z.boolean(),
     canRevoke: z.boolean(),
+    canClearQuota: z
+        .boolean()
+        .describe('The viewer may clear an unknown-reset quota mark.'),
+    recentRunsCount: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe('Recent run rows shown by the Runs tab, bounded to ten.'),
     updateVersion: z.string().nullable(),
     requiredProtocol: z.object({
         min: z.number().int(),
@@ -1189,8 +1404,60 @@ export const RunnerSummarySchema = runnerObject
     }),
 })
     .meta({ ref: 'AgentsRunnerSummary' });
+export const RunnerSummarySchema = runnerSummaryObject;
+export const RunnerListItemSchema = runnerSummaryObject
+    .pick(RUNNER_LIST_FIELDS)
+    .extend({
+    tools: z
+        .array(z
+        .object({
+        kind: AgentToolSchema,
+        version: z.string().optional(),
+        authenticated: z.boolean(),
+    })
+        .meta({
+        ref: 'AgentsRunnerToolSummary',
+        description: 'Tool identity, version and sign-in state; model catalogs and machine paths belong to runtime get.',
+    }))
+        .describe('Compact coding tool states for this list.'),
+    takesCount: z
+        .number()
+        .int()
+        .describe('Total eligible agents; takes contains at most three.'),
+    workspaceUsage: RunnerWorkspaceUsageSchema.omit({ workspaces: true })
+        .nullable()
+        .optional()
+        .describe('Directory and disk totals without directory rows.'),
+})
+    .meta({ ref: 'AgentsRunnerListItem' });
+export const RunnerWorkspacePageMetaSchema = z
+    .object({
+    total: z
+        .number()
+        .int()
+        .describe('Directories matching the selected status.'),
+    page: z.number().int().min(1).describe('The requested one-based page.'),
+    pageSize: z.number().int().min(1).describe('Maximum rows per page.'),
+    usage: RunnerWorkspaceUsageSchema.omit({ workspaces: true })
+        .nullable()
+        .describe('Disk and directory totals, without directory rows.'),
+})
+    .meta({
+    ref: 'AgentsRunnerWorkspacePageMeta',
+    description: 'Paging and shared runtime workspace totals.',
+});
 export const RunnerRecentRunSchema = z
     .object({
+    subjectLabel: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('The visible task or conversation label.'),
+    failureReason: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Terminal failure classification, including toolQuota.'),
     id: z.string(),
     title: z.string(),
     status: RunStatusSchema,
@@ -1219,6 +1486,20 @@ export const RegistrationTokenSchema = z.object({
     toolSlots: ToolSlotsSchema.nullable(),
     expiresAt: dateTime,
 });
+export const RegistrationTokenListQuery = z.object({
+    page: z.coerce.number().int().min(1).default(1).describe('The page number.'),
+    pageSize: pageSize(50, 100).describe('The maximum number of registration tokens to return.'),
+});
+export const RegistrationTokenSummarySchema = z.object({
+    id: z.string(),
+    createdById: z.string().nullable(),
+    trust: z.enum(RUNNER_TRUST),
+    enabledTools: z.array(AgentToolSchema).nullable(),
+    slots: z.number().int().nullable(),
+    toolSlots: ToolSlotsSchema.nullable().optional(),
+    createdAt: dateTime,
+    expiresAt: dateTime,
+});
 export const DownloadTokenSchema = z.object({
     token: z.string().meta({
         description: 'The download token, shown only in this answer; the install script downloads the CLI with it.',
@@ -1236,18 +1517,21 @@ export const RunContextSchema = z
 });
 // Run requests: work someone asked of an agent on a subject another person answers for.
 export const RunRequestParams = z.object({
-    requestId: id,
+    requestId: id.describe('The request identifier.'),
 });
 export const RunRequestListQuery = z.object({
     role: z.enum(['responsible', 'requester']).optional().meta({
         description: '`responsible`: the requests the caller answers for (to confirm); `requester`: the ones the caller asked. Both when left out.',
     }),
-    status: z.enum(RUN_REQUEST_STATUSES).optional(),
-    subjectKind: id.optional(),
-    subjectId: id.optional(),
-    agentId: id.optional(),
-    pageSize: pageSize(50, 200),
-    pageToken,
+    status: z
+        .enum(RUN_REQUEST_STATUSES)
+        .optional()
+        .describe('The status to set or filter by.'),
+    subjectKind: id.optional().describe('The kind of subject.'),
+    subjectId: id.optional().describe('The subject identifier.'),
+    agentId: id.optional().describe('The agent identifier.'),
+    pageSize: pageSize(50, 200).describe('The maximum number of records to return.'),
+    pageToken: pageToken.describe('The continuation token returned by the previous page.'),
 });
 export const RunRequestRejectInput = z.strictObject({
     note: z.string().max(2000).optional().meta({