@ancplua/qyl-api-schema 3.0.0 → 5.0.0

package/models/mcp-tools.tsp

@@ -2,11 +2,13 @@ import "../common/types.tsp";
 import "../otel/logs.tsp";
 import "../otel/span.tsp";
 import "./session.tsp";
+import "./workflow.tsp";
 
 using Qyl.Api.Contracts.Common;
 using Qyl.Api.Contracts.Domains.Observe.Session;
 using Qyl.Api.Contracts.OTel.Logs;
 using Qyl.Api.Contracts.OTel.Traces;
+using Qyl.Api.Contracts.Workflow;
 
 namespace Qyl.Api.Contracts.Mcp.Tools;
 
@@ -117,6 +119,76 @@ model SearchLogsOutput {
   mode: McpDataMode;
 }
 
+@doc("Outcome of one CI phase span, projected from its OpenTelemetry span status.")
+enum CiPhaseStatus {
+  ok: "ok",
+  error: "error",
+  unset: "unset",
+}
+
+@doc("Input for ci_log.")
+model CiLogInput {
+  @doc("Session id of one CI run for a per-leg phase breakdown; omit to list recent runs.")
+  @encodedName("application/json", "run_id")
+  runId?: SessionId;
+
+  @doc("Maximum CI runs to list.")
+  @minValue(1)
+  @maxValue(50)
+  limit?: int32 = 10;
+}
+
+@doc("One CI run, summarized from the session its telemetry is grouped under.")
+model CiRunSummary {
+  @encodedName("application/json", "run_id")
+  runId: SessionId;
+
+  state: SessionState;
+
+  @encodedName("application/json", "start_time")
+  startTime: utcDateTime;
+
+  @encodedName("application/json", "duration_ms")
+  durationMs?: DurationMs;
+
+  @doc("Spans in the run that ended with an error status.")
+  @encodedName("application/json", "error_count")
+  @minValue(0)
+  errorCount: int32;
+
+  @doc("Service names observed in the run, at least one of which is CI-emitted.")
+  services: string[];
+}
+
+@doc("One phase span of a CI run, attributed to the leg that executed it.")
+model CiPhase {
+  @doc("Value of the span's ci.leg attribute, falling back to its service name.")
+  leg: string;
+
+  @doc("Span name, which the CI emitter convention sets to the phase name.")
+  phase: string;
+
+  status: CiPhaseStatus;
+
+  @encodedName("application/json", "duration_ms")
+  durationMs: DurationMs;
+
+  @doc("Span status message, present on a failed phase.")
+  message?: string;
+}
+
+@doc("Structured output for ci_log: recent runs, or one run's phases.")
+model CiLogOutput {
+  runs?: CiRunSummary[];
+
+  @encodedName("application/json", "run_id")
+  runId?: SessionId;
+
+  phases?: CiPhase[];
+
+  mode: McpDataMode;
+}
+
 @doc("Input for the app-only fetch_telemetry tool.")
 model FetchTelemetryInput {
   view: FetchTelemetryView;
@@ -146,6 +218,157 @@ model FetchTelemetryOutput {
   mode: McpDataMode;
 }
 
+@doc("Input for list_workflow_runs.")
+model ListWorkflowRunsInput {
+  status?: WorkflowRunStatus;
+
+  cursor?: string;
+
+  @minValue(1)
+  @maxValue(100)
+  limit?: int32 = 20;
+}
+
+@doc("Structured output for list_workflow_runs.")
+model ListWorkflowRunsOutput {
+  runs: WorkflowRun[];
+
+  @encodedName("application/json", "next_cursor")
+  nextCursor?: string;
+
+  @encodedName("application/json", "has_more")
+  hasMore: boolean;
+
+  mode: McpDataMode;
+}
+
+@doc("Input for get_workflow_graph.")
+model GetWorkflowGraphInput {
+  @encodedName("application/json", "run_id")
+  runId: WorkflowRunId;
+
+  @encodedName("application/json", "node_cursor")
+  nodeCursor?: string;
+
+  @encodedName("application/json", "node_limit")
+  @minValue(1)
+  @maxValue(1000)
+  nodeLimit?: int32 = 250;
+
+  @encodedName("application/json", "edge_cursor")
+  edgeCursor?: string;
+
+  @encodedName("application/json", "edge_limit")
+  @minValue(1)
+  @maxValue(2000)
+  edgeLimit?: int32 = 500;
+}
+
+@doc("Structured output for get_workflow_graph.")
+model GetWorkflowGraphOutput {
+  graph: WorkflowGraphSnapshot;
+  mode: McpDataMode;
+}
+
+@doc("Input for display_workflow_graph. Omit run_id to select the most recent run.")
+model DisplayWorkflowGraphInput {
+  @encodedName("application/json", "run_id")
+  runId?: WorkflowRunId;
+
+  @encodedName("application/json", "node_cursor")
+  nodeCursor?: string;
+
+  @encodedName("application/json", "node_limit")
+  @minValue(1)
+  @maxValue(1000)
+  nodeLimit?: int32 = 250;
+
+  @encodedName("application/json", "edge_cursor")
+  edgeCursor?: string;
+
+  @encodedName("application/json", "edge_limit")
+  @minValue(1)
+  @maxValue(2000)
+  edgeLimit?: int32 = 500;
+}
+
+@doc("Structured output for display_workflow_graph.")
+model DisplayWorkflowGraphOutput {
+  graph: WorkflowGraphSnapshot;
+
+  @encodedName("application/json", "live_controls_available")
+  liveControlsAvailable: boolean;
+
+  mode: McpDataMode;
+}
+
+@doc("Input for the app-only fetch_workflow_graph_updates tool.")
+model FetchWorkflowGraphUpdatesInput {
+  @encodedName("application/json", "run_id")
+  runId: WorkflowRunId;
+
+  @encodedName("application/json", "after_sequence")
+  afterSequence: WorkflowSequence;
+
+  @minValue(1)
+  @maxValue(1000)
+  limit?: int32 = 250;
+
+  @encodedName("application/json", "wait_ms")
+  @minValue(0)
+  @maxValue(30000)
+  waitMs?: int32 = 20000;
+
+  @encodedName("application/json", "node_cursor")
+  nodeCursor?: string;
+
+  @encodedName("application/json", "node_limit")
+  @minValue(1)
+  @maxValue(1000)
+  nodeLimit?: int32 = 250;
+
+  @encodedName("application/json", "edge_cursor")
+  edgeCursor?: string;
+
+  @encodedName("application/json", "edge_limit")
+  @minValue(1)
+  @maxValue(2000)
+  edgeLimit?: int32 = 500;
+
+  @doc("Optional captured payload to retrieve lazily for the selected run.")
+  @encodedName("application/json", "content_ref")
+  contentRef?: WorkflowContentRef;
+}
+
+@doc("Structured output for the app-only fetch_workflow_graph_updates tool.")
+model FetchWorkflowGraphUpdatesOutput {
+  page: WorkflowEventPage;
+  graph?: WorkflowGraphSnapshot;
+  content?: WorkflowContent;
+  mode: McpDataMode;
+}
+
+@doc("Input for control_workflow_run.")
+model ControlWorkflowRunInput {
+  @encodedName("application/json", "run_id")
+  runId: WorkflowRunId;
+
+  action: WorkflowControlAction;
+
+  @encodedName("application/json", "idempotency_key")
+  @minLength(1)
+  @maxLength(160)
+  idempotencyKey: string;
+
+  @maxLength(32768)
+  input?: string;
+}
+
+@doc("Structured output for control_workflow_run.")
+model ControlWorkflowRunOutput {
+  command: WorkflowControlCommand;
+}
+
 @doc("Aggregate MCP traffic statistics shown by qyl.mcp.")
 model McpDashboardStats {
   window: McpDashboardWindow;