@ancplua/qyl-api-schema 11.5.0 → 11.6.0-rc.1

package/generated/ts-runtime/api.d.ts

@@ -57,6 +57,13 @@ export declare const TimeBucketValues: {
     readonly auto: "auto";
 };
 export type TimeBucket = typeof TimeBucketValues[keyof typeof TimeBucketValues];
+export declare const CollectorKeyRoleValues: {
+    readonly ingest: "ingest";
+    readonly read: "read";
+    readonly write: "write";
+    readonly delete: "delete";
+};
+export type CollectorKeyRole = typeof CollectorKeyRoleValues[keyof typeof CollectorKeyRoleValues];
 export declare const SpanKindValues: {
     readonly unspecified: 0;
     readonly internal: 1;
@@ -215,6 +222,11 @@ export declare const MetricAggregationValues: {
     readonly p99: "p99";
 };
 export type MetricAggregation = typeof MetricAggregationValues[keyof typeof MetricAggregationValues];
+export declare const MetricMatcherOpValues: {
+    readonly eq: "eq";
+    readonly prefix: "prefix";
+};
+export type MetricMatcherOp = typeof MetricMatcherOpValues[keyof typeof MetricMatcherOpValues];
 export declare const SessionEventNameValues: {
     readonly sessionStart: "session.start";
     readonly sessionEnd: "session.end";
@@ -394,6 +406,23 @@ export declare const CiPhaseStatusValues: {
     readonly unset: "unset";
 };
 export type CiPhaseStatus = typeof CiPhaseStatusValues[keyof typeof CiPhaseStatusValues];
+export declare const SavedQuerySignalValues: {
+    readonly traces: "traces";
+    readonly logs: "logs";
+    readonly metrics: "metrics";
+};
+export type SavedQuerySignal = typeof SavedQuerySignalValues[keyof typeof SavedQuerySignalValues];
+export declare const DeletableKindValues: {
+    readonly annotation: "annotation";
+    readonly savedQuery: "saved_query";
+};
+export type DeletableKind = typeof DeletableKindValues[keyof typeof DeletableKindValues];
+export declare const McpScopeValues: {
+    readonly read: "qyl:read";
+    readonly write: "qyl:write";
+    readonly delete: "qyl:delete";
+};
+export type McpScope = typeof McpScopeValues[keyof typeof McpScopeValues];
 export declare const FetchTelemetryViewValues: {
     readonly traces: "traces";
     readonly trace: "trace";
@@ -404,7 +433,7 @@ export type FetchTelemetryView = typeof FetchTelemetryViewValues[keyof typeof Fe
 export type AttributeDouble = number | "NaN" | "Infinity" | "-Infinity";
 export type AttributeValue = null | string | boolean | AttributeValue[] | AttributeObjectValue;
 export type AttributeObjectValue = AttributeIntValue | AttributeDoubleValue | AttributeBytesValue | AttributeKeyValueListValue;
-export type ApiError = NotFoundError | ValidationError | UnauthorizedError | ForbiddenError | ConflictError | RateLimitError | InternalServerError | BadGatewayError | ServiceUnavailableError;
+export type ApiError = NotFoundError | ValidationError | UnauthorizedError | ForbiddenError | ConflictError | PreconditionFailedError | PreconditionRequiredError | RateLimitError | InternalServerError | BadGatewayError | ServiceUnavailableError;
 export type RunnerResourceEvents = RunnerResourceState;
 export type RunnerLogEvents = RunnerLogLine;
 export type WorkbenchServerConfiguration = WorkbenchStdioServerConfiguration | WorkbenchStreamableHttpServerConfiguration | WorkbenchBuiltinServerConfiguration;
@@ -412,6 +441,11 @@ export type WorkbenchTestAssertion = WorkbenchStatusAssertion | WorkbenchExactAs
 export type WorkbenchEvaluationExportPayload = WorkbenchEvaluationJsonExportPayload | WorkbenchEvaluationReportExportPayload;
 export type WorkbenchProtocolEvents = WorkbenchProtocolEvent;
 export type WorkbenchExecutionUpdateEvents = WorkbenchExecutionRecord;
+export type ToolErrorCode = "invalid_argument" | "not_found" | "no_project_access" | "collector_unreachable" | "collector_timeout" | "cancelled" | "collector_unauthorized" | "collector_rate_limited" | "collector_rejected" | "collector_error" | "contract_mismatch" | "insufficient_scope" | "conflict" | "precondition_failed" | "precondition_required" | "internal";
+export type AnnotationTarget = TraceAnnotationTarget | SpanAnnotationTarget | SessionAnnotationTarget;
+export type SavedQueryFilter = SavedTraceQueryFilter | SavedLogQueryFilter | SavedMetricQueryFilter;
+export type SavedQueryRunResult = SavedTraceQueryRun | SavedLogQueryRun | SavedMetricQueryRun;
+export type FetchTelemetryInput = FetchTelemetryTracesInput | FetchTelemetryTraceInput | FetchTelemetryLogsInput | FetchTelemetryMcpStatsInput;
 export type LogEvents = LogStreamEvent | HeartbeatEvent;
 export interface AttributeBytesValue {
     "type": "bytes";
@@ -448,6 +482,12 @@ export interface InstrumentationScope {
     "attributes"?: Attribute[];
     "dropped_attributes_count"?: number;
 }
+export interface ResourceBase {
+    "id": string;
+    "created_at": string;
+    "updated_at": string;
+    "etag": string;
+}
 export interface ProblemDetails {
     "type": string;
     "title": string;
@@ -482,6 +522,14 @@ export interface ConflictError extends ProblemDetails {
     "title": "Conflict";
     "conflicting_resource"?: string;
 }
+export interface PreconditionFailedError extends ProblemDetails {
+    "title": "Precondition Failed";
+    "current_etag"?: string;
+}
+export interface PreconditionRequiredError extends ProblemDetails {
+    "title": "Precondition Required";
+    "required_header"?: "If-Match";
+}
 export interface RateLimitError extends ProblemDetails {
     "title": "Too Many Requests";
 }
@@ -704,6 +752,11 @@ export interface MetricQueryResult {
     "series": MetricSeriesResult[];
     "truncated": boolean;
 }
+export interface MetricAttributeMatcher {
+    "key": string;
+    "op": MetricMatcherOp;
+    "value": string;
+}
 export interface SessionAttributes {
     "session_id": SessionId;
     "previous_session_id"?: SessionId;
@@ -1284,6 +1337,19 @@ export interface WorkbenchEvaluationExportArtifact {
 export interface WorkbenchEvaluationExportAccepted {
     "export": WorkbenchEvaluationExport;
 }
+export interface ToolError {
+    "code": ToolErrorCode;
+    "message": string;
+    "retryable": boolean;
+}
+export interface ToolPage {
+    "has_more": boolean;
+    "next_cursor"?: string;
+}
+export interface ToolTimeRange {
+    "start_time"?: string;
+    "end_time"?: string;
+}
 export interface DisplayTracesInput {
     "trace_id"?: TraceId;
     "session_id"?: SessionId;
@@ -1293,12 +1359,14 @@ export interface DisplayTracesOutput {
     "traces": Trace[];
     "selected_trace_id"?: TraceId;
     "mode": McpDataMode;
+    "error"?: ToolError;
 }
 export interface DisplayMcpDashboardInput {
     "hours"?: number;
 }
 export interface DisplayMcpDashboardOutput {
     "stats": McpDashboardStats;
+    "error"?: ToolError;
 }
 export interface McpDashboardStats {
     "window": McpDashboardWindow;
@@ -1341,10 +1409,18 @@ export interface McpToolStats {
 }
 export interface ListTracesInput {
     "limit"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "service_name"?: string;
+    "errors_only"?: boolean;
+    "cursor"?: string;
 }
 export interface ListTracesOutput {
     "traces": TraceSummary[];
     "mode": McpDataMode;
+    "has_more": boolean;
+    "next_cursor"?: string;
+    "error"?: ToolError;
 }
 export interface GetTraceInput {
     "trace_id": TraceId;
@@ -1355,14 +1431,40 @@ export interface GetTraceInput {
 export interface GetTraceOutput {
     "trace": Trace;
     "mode": McpDataMode;
+    "annotations"?: Annotation[];
+    "error"?: ToolError;
+}
+export interface Annotation extends ResourceBase {
+    "target": AnnotationTarget;
+    "text": string;
+}
+export interface TraceAnnotationTarget {
+    "kind": "trace";
+    "trace_id": TraceId;
+}
+export interface SpanAnnotationTarget {
+    "kind": "span";
+    "trace_id": TraceId;
+    "span_id": SpanId;
+}
+export interface SessionAnnotationTarget {
+    "kind": "session";
+    "session_id": SessionId;
 }
 export interface ListSessionsInput {
     "limit"?: number;
     "active_only"?: boolean;
+    "start_time"?: string;
+    "end_time"?: string;
+    "cursor"?: string;
 }
 export interface ListSessionsOutput {
     "sessions": SessionEntity[];
     "mode": McpDataMode;
+    "has_more": boolean;
+    "next_cursor"?: string;
+    "annotations"?: Annotation[];
+    "error"?: ToolError;
 }
 export interface SearchLogsInput {
     "trace_id"?: TraceId;
@@ -1370,10 +1472,17 @@ export interface SearchLogsInput {
     "severity_min"?: number;
     "query"?: string;
     "limit"?: number;
+    "session_id"?: SessionId;
+    "start_time"?: string;
+    "end_time"?: string;
+    "cursor"?: string;
 }
 export interface SearchLogsOutput {
     "logs": LogRecord[];
     "mode": McpDataMode;
+    "has_more": boolean;
+    "next_cursor"?: string;
+    "error"?: ToolError;
 }
 export interface CiLogInput {
     "run_id"?: SessionId;
@@ -1400,14 +1509,27 @@ export interface CiLogOutput {
     "run_id"?: SessionId;
     "phases"?: CiPhase[];
     "mode": McpDataMode;
+    "error"?: ToolError;
+}
+export interface FetchTelemetryTracesInput {
+    "view": "traces";
+    "trace_id"?: TraceId;
+    "limit"?: number;
 }
-export interface FetchTelemetryInput {
-    "view": FetchTelemetryView;
+export interface FetchTelemetryTraceInput {
+    "view": "trace";
+    "trace_id": TraceId;
+}
+export interface FetchTelemetryLogsInput {
+    "view": "logs";
     "trace_id"?: TraceId;
     "service_name"?: string;
     "severity_min"?: number;
     "query"?: string;
     "limit"?: number;
+}
+export interface FetchTelemetryMcpStatsInput {
+    "view": "mcp_stats";
     "hours"?: number;
 }
 export interface FetchTelemetryOutput {
@@ -1416,6 +1538,184 @@ export interface FetchTelemetryOutput {
     "logs"?: LogRecord[];
     "stats"?: McpDashboardStats;
     "mode": McpDataMode;
+    "error"?: ToolError;
+}
+export interface ListMetricsInput {
+    "name_prefix"?: string;
+    "limit"?: number;
+    "cursor"?: string;
+}
+export interface ListMetricsOutput {
+    "items": MetricDescriptor[];
+    "has_more": boolean;
+    "next_cursor"?: string;
+    "error"?: ToolError;
+}
+export interface GetMetricSeriesInput {
+    "metric_name": string;
+    "matchers"?: MetricAttributeMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+}
+export interface GetMetricSeriesOutput {
+    "items": MetricSeries[];
+    "has_more": boolean;
+    "next_cursor"?: string;
+    "error"?: ToolError;
+}
+export interface QueryMetricInput {
+    "metric_name": string;
+    "start_time": string;
+    "end_time": string;
+    "step_ms"?: number;
+    "aggregation"?: MetricAggregation;
+    "group_by"?: string[];
+    "matchers"?: MetricAttributeMatcher[];
+    "series_limit"?: number;
+}
+export interface QueryMetricOutput {
+    "name": string;
+    "kind": MetricKind;
+    "unit"?: string;
+    "aggregation": MetricAggregation;
+    "step_ms": number;
+    "start_time": string;
+    "end_time": string;
+    "series": MetricSeriesResult[];
+    "truncated": boolean;
+    "error"?: ToolError;
+}
+export interface CreateAnnotationInput {
+    "target": AnnotationTarget;
+    "text": string;
+}
+export interface UpdateAnnotationInput {
+    "id": string;
+    "etag": string;
+    "text": string;
+}
+export interface AnnotationOutput {
+    "annotation"?: Annotation;
+    "error"?: ToolError;
+}
+export interface CreateSavedQueryInput {
+    "name": string;
+    "description"?: string;
+    "filter": SavedQueryFilter;
+}
+export interface SavedTraceQueryFilter {
+    "signal": "traces";
+    "lookback_minutes"?: number;
+    "service_name"?: string;
+    "errors_only"?: boolean;
+}
+export interface SavedLogQueryFilter {
+    "signal": "logs";
+    "lookback_minutes"?: number;
+    "service_name"?: string;
+    "severity_min"?: SeverityNumber;
+    "session_id"?: SessionId;
+    "trace_id"?: TraceId;
+    "query"?: string;
+}
+export interface SavedMetricQueryFilter {
+    "signal": "metrics";
+    "lookback_minutes"?: number;
+    "metric_name": string;
+    "aggregation"?: MetricAggregation;
+    "step_ms"?: number;
+    "group_by"?: string[];
+    "matchers"?: MetricAttributeMatcher[];
+}
+export interface UpdateSavedQueryInput {
+    "id": string;
+    "etag": string;
+    "name"?: string;
+    "description"?: string;
+    "filter"?: SavedQueryFilter;
+}
+export interface SavedQueryOutput {
+    "saved_query"?: SavedQuery;
+    "error"?: ToolError;
+}
+export interface SavedQuery extends ResourceBase {
+    "name": string;
+    "description"?: string;
+    "filter": SavedQueryFilter;
+}
+export interface ListSavedQueriesInput {
+    "signal"?: SavedQuerySignal;
+    "limit"?: number;
+    "cursor"?: string;
+}
+export interface ListSavedQueriesOutput {
+    "saved_queries": SavedQuery[];
+    "has_more": boolean;
+    "next_cursor"?: string;
+    "error"?: ToolError;
+}
+export interface RunSavedQueryInput {
+    "id": string;
+    "start_time"?: string;
+    "end_time"?: string;
+    "limit"?: number;
+    "cursor"?: string;
+}
+export interface RunSavedQueryOutput {
+    "result"?: SavedQueryRunResult;
+    "mode"?: McpDataMode;
+    "error"?: ToolError;
+}
+export interface SavedTraceQueryRun {
+    "signal": "traces";
+    "items": TraceSummary[];
+    "next_cursor"?: string;
+    "has_more": boolean;
+}
+export interface SavedLogQueryRun {
+    "signal": "logs";
+    "items": LogRecord[];
+    "next_cursor"?: string;
+    "has_more": boolean;
+}
+export interface SavedMetricQueryRun {
+    "signal": "metrics";
+    "result": MetricQueryResult;
+}
+export interface DeleteInput {
+    "kind": DeletableKind;
+    "id": string;
+    "etag": string;
+}
+export interface DeleteOutput {
+    "deleted": boolean;
+    "error"?: ToolError;
+}
+export interface AnnotationCreateRequest {
+    "target": AnnotationTarget;
+    "text": string;
+}
+export interface AnnotationUpdateRequest {
+    "text": string;
+}
+export interface SavedQueryCreateRequest {
+    "name": string;
+    "description"?: string;
+    "filter": SavedQueryFilter;
+}
+export interface SavedQueryWindow {
+    "lookback_minutes"?: number;
+}
+export interface SavedQueryUpdateRequest {
+    "name"?: string;
+    "description"?: string;
+    "filter"?: SavedQueryFilter;
+}
+export interface SavedQueryRunRequest {
+    "start_time"?: string;
+    "end_time"?: string;
+    "limit"?: number;
+    "cursor"?: string;
 }
 export interface LogStreamEvent {
     "type": "log";
@@ -1462,5 +1762,17 @@ export interface CursorPageSessionEntity {
     "prev_cursor"?: string;
     "has_more": boolean;
 }
+export interface CursorPageAnnotation {
+    "items": Annotation[];
+    "next_cursor"?: string;
+    "prev_cursor"?: string;
+    "has_more": boolean;
+}
+export interface CursorPageSavedQuery {
+    "items": SavedQuery[];
+    "next_cursor"?: string;
+    "prev_cursor"?: string;
+    "has_more": boolean;
+}
 /** Revision of the API contract these types were emitted from; compare against HealthReport.contract_revision. */
 export declare const CONTRACT_REVISION: string;

package/generated/ts-runtime/api.js

@@ -41,6 +41,12 @@ export const TimeBucketValues = {
     "week": "1w",
     "auto": "auto",
 };
+export const CollectorKeyRoleValues = {
+    "ingest": "ingest",
+    "read": "read",
+    "write": "write",
+    "delete": "delete",
+};
 export const SpanKindValues = {
     "unspecified": 0,
     "internal": 1,
@@ -185,6 +191,10 @@ export const MetricAggregationValues = {
     "p95": "p95",
     "p99": "p99",
 };
+export const MetricMatcherOpValues = {
+    "eq": "eq",
+    "prefix": "prefix",
+};
 export const SessionEventNameValues = {
     "sessionStart": "session.start",
     "sessionEnd": "session.end",
@@ -339,6 +349,20 @@ export const CiPhaseStatusValues = {
     "error": "error",
     "unset": "unset",
 };
+export const SavedQuerySignalValues = {
+    "traces": "traces",
+    "logs": "logs",
+    "metrics": "metrics",
+};
+export const DeletableKindValues = {
+    "annotation": "annotation",
+    "savedQuery": "saved_query",
+};
+export const McpScopeValues = {
+    "read": "qyl:read",
+    "write": "qyl:write",
+    "delete": "qyl:delete",
+};
 export const FetchTelemetryViewValues = {
     "traces": "traces",
     "trace": "trace",
@@ -347,4 +371,4 @@ export const FetchTelemetryViewValues = {
 };
 // --- contract revision (scripts/emit-contract-revision.mjs) ---
 /** Revision of the API contract these types were emitted from; compare against HealthReport.contract_revision. */
-export const CONTRACT_REVISION = "sha256:3605ae27d2edf632";
+export const CONTRACT_REVISION = "sha256:d926c3c6ab829cbf";