@tonyclaw/agent-inspector 2.0.26 → 2.0.28

package/src/lib/runContract.ts

@@ -0,0 +1,162 @@
+import { z } from "zod";
+import { JsonValueSchema } from "../proxy/schemas";
+import { SessionInfoSchema } from "./sessionInfoContract";
+
+export const InspectorRunStatusSchema = z.enum([
+  "created",
+  "running",
+  "completed",
+  "failed",
+  "cancelled",
+]);
+
+export const InspectorRunEvidenceSchema = z.object({
+  jsonPath: z.string(),
+  markdownPath: z.string(),
+  htmlPath: z.string(),
+  exportedAt: z.string(),
+});
+
+export const RunTimelineEventKindSchema = z.enum([
+  "run-created",
+  "session-started",
+  "request",
+  "session-finished",
+  "evidence-exported",
+]);
+
+export const RunTimelineEventSeveritySchema = z.enum(["info", "success", "warning", "error"]);
+
+export const RunTimelineEventSchema = z.object({
+  timestamp: z.string(),
+  kind: RunTimelineEventKindSchema,
+  severity: RunTimelineEventSeveritySchema,
+  title: z.string(),
+  details: z.string(),
+  logId: z.number().int().positive().nullable(),
+  status: z.number().nullable(),
+  model: z.string().nullable(),
+  provider: z.string().nullable(),
+  latencyMs: z.number().nullable(),
+  isStreaming: z.boolean().nullable(),
+});
+
+export const FailureCategorySchema = z.enum([
+  "none",
+  "active",
+  "provider-timeout",
+  "provider-http-error",
+  "provider-auth-error",
+  "provider-rate-limit",
+  "network-or-container",
+  "streaming-mismatch",
+  "context-pressure",
+  "runtime-task-error",
+  "model-output-error",
+  "unknown-failure",
+  "no-session-data",
+]);
+
+export const FailureClassificationSchema = z.object({
+  outcome: z.enum(["success", "failure", "active", "unknown"]),
+  severity: z.enum(["none", "low", "medium", "high"]),
+  category: FailureCategorySchema,
+  summary: z.string(),
+  evidenceLogIds: z.array(z.number().int().positive()),
+  hints: z.array(z.string()),
+});
+
+export const JenkinsReportSchema = z.object({
+  status: z.enum(["PASS", "FAIL", "RUNNING", "UNKNOWN"]),
+  summary: z.string(),
+  markdown: z.string(),
+});
+
+export const InspectorRunSchema = z.object({
+  id: z.string(),
+  sessionId: z.string(),
+  title: z.string(),
+  task: z.string().nullable(),
+  project: z.string().nullable(),
+  agent: z.string().nullable(),
+  status: InspectorRunStatusSchema,
+  tags: z.array(z.string()),
+  metadata: z.record(z.string(), JsonValueSchema),
+  evidence: InspectorRunEvidenceSchema.nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export const CreateInspectorRunInputSchema = z
+  .object({
+    runId: z.string().min(1).optional(),
+    sessionId: z.string().min(1).optional(),
+    title: z.string().min(1).optional(),
+    task: z.string().nullable().optional(),
+    project: z.string().nullable().optional(),
+    agent: z.string().nullable().optional(),
+    status: InspectorRunStatusSchema.optional(),
+    tags: z.array(z.string()).optional(),
+    metadata: z.record(z.string(), JsonValueSchema).optional(),
+  })
+  .optional();
+
+export const UpdateInspectorRunInputSchema = z.object({
+  sessionId: z.string().min(1).optional(),
+  title: z.string().min(1).optional(),
+  task: z.string().nullable().optional(),
+  project: z.string().nullable().optional(),
+  agent: z.string().nullable().optional(),
+  status: InspectorRunStatusSchema.optional(),
+  tags: z.array(z.string()).optional(),
+  metadata: z.record(z.string(), JsonValueSchema).optional(),
+});
+
+export const EvidenceExportOptionsSchema = z
+  .object({
+    includeHistory: z.boolean().optional(),
+    latestLogLimit: z.number().int().positive().max(50).optional(),
+  })
+  .optional();
+
+export const EvidenceExportResultSchema = z.object({
+  run: InspectorRunSchema,
+  evidence: InspectorRunEvidenceSchema,
+  session: SessionInfoSchema.nullable(),
+  timeline: z.array(RunTimelineEventSchema),
+  classification: FailureClassificationSchema,
+  jenkinsReport: JenkinsReportSchema,
+});
+
+export const RecentFailureSchema = z.object({
+  run: InspectorRunSchema,
+  classification: FailureClassificationSchema,
+  evidence: InspectorRunEvidenceSchema.nullable(),
+  jenkinsReport: JenkinsReportSchema.nullable(),
+  sessionId: z.string(),
+  inspectorUrl: z.string().nullable(),
+  evidenceMarkdownPath: z.string().nullable(),
+  updatedAt: z.string(),
+});
+
+export const RecentFailuresResponseSchema = z.object({
+  failures: z.array(RecentFailureSchema),
+  total: z.number().int().nonnegative(),
+  limit: z.number().int().positive(),
+});
+
+export type InspectorRunStatus = z.infer<typeof InspectorRunStatusSchema>;
+export type InspectorRunEvidence = z.infer<typeof InspectorRunEvidenceSchema>;
+export type RunTimelineEventKind = z.infer<typeof RunTimelineEventKindSchema>;
+export type RunTimelineEventSeverity = z.infer<typeof RunTimelineEventSeveritySchema>;
+export type RunTimelineEvent = z.infer<typeof RunTimelineEventSchema>;
+export type FailureCategory = z.infer<typeof FailureCategorySchema>;
+export type FailureClassification = z.infer<typeof FailureClassificationSchema>;
+export type JenkinsReport = z.infer<typeof JenkinsReportSchema>;
+export type InspectorRun = z.infer<typeof InspectorRunSchema>;
+export type CreateInspectorRunInput = z.infer<typeof CreateInspectorRunInputSchema>;
+export type UpdateInspectorRunInput = z.infer<typeof UpdateInspectorRunInputSchema>;
+export type EvidenceExportOptions = z.infer<typeof EvidenceExportOptionsSchema>;
+export type EvidenceExportResult = z.infer<typeof EvidenceExportResultSchema>;
+export type RecentFailure = z.infer<typeof RecentFailureSchema>;
+export type RecentFailuresResponse = z.infer<typeof RecentFailuresResponseSchema>;