@ancplua/qyl-api-schema 6.0.0 → 7.1.0

package/generated/otel-keys.gen.tsp

@@ -1,7 +1,7 @@
 // <auto-generated/>
 // Generated by qyl's Weaver pipeline (emit_typespec_keys.py) from:
 //   open-telemetry/semantic-conventions v1.43.0 (89aae438b3b3b0a8dd33003c9d70592baf7dbd0d)
-//   open-telemetry/semantic-conventions-genai 64cfaa612a1af8472b2f063374fbe3c9e6cea2ab (64cfaa612a1af8472b2f063374fbe3c9e6cea2ab)
+//   open-telemetry/semantic-conventions-genai f77b9235f2ad49fe95b61e9809ca82bb08ef9d47 (f77b9235f2ad49fe95b61e9809ca82bb08ef9d47)
 // Schema: https://opentelemetry.io/schemas/1.43.0
 // GenAI schema: https://opentelemetry.io/schemas/gen-ai-dev/1.42.0-dev
 // Licensed under Apache-2.0 (inherited from OpenTelemetry upstream)
@@ -891,6 +891,8 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.GenAi {
   const RequestStopSequences: string = "gen_ai.request.stop_sequences";
   /** Indicates whether the GenAI request was made in streaming mode. */
   const RequestStream: string = "gen_ai.request.stream";
+  /** The cursor identifying the last streamed event already received, used to resume a streamed response from that position. */
+  const RequestStreamCursor: string = "gen_ai.request.stream_cursor";
   /** The temperature setting for the GenAI request. */
   const RequestTemperature: string = "gen_ai.request.temperature";
   /** The top-K sampling setting for the GenAI request: restricts token generation at each step to the K most likely next tokens. */
@@ -903,6 +905,8 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.GenAi {
   const ResponseId: string = "gen_ai.response.id";
   /** The name of the model that generated the response. */
   const ResponseModel: string = "gen_ai.response.model";
+  /** The lifecycle status of a generated response, as reported by the provider when the response is fetched or polled. */
+  const ResponseStatus: string = "gen_ai.response.status";
   /** Time to first chunk in a streaming response, measured from request issuance, in seconds. The value is measured from when the client issues the generation request to when the first chunk is received in the response stream. */
   const ResponseTimeToFirstChunk: string = "gen_ai.response.time_to_first_chunk";
   /** The documents retrieved. */

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

@@ -34,12 +34,21 @@ export type WorkbenchSuiteId = string & {
 export type WorkbenchEvaluationExportId = string & {
     readonly __brand: "WorkbenchEvaluationExportId";
 };
+export type WorkflowGeneration = string & {
+    readonly __brand: "WorkflowGeneration";
+};
+export type WorkflowJournalPosition = string & {
+    readonly __brand: "WorkflowJournalPosition";
+};
 export type WorkflowRunId = string & {
     readonly __brand: "WorkflowRunId";
 };
 export type WorkflowAttemptId = string & {
     readonly __brand: "WorkflowAttemptId";
 };
+export type WorkflowRunCursor = string & {
+    readonly __brand: "WorkflowRunCursor";
+};
 export type WorkflowContentRef = string & {
     readonly __brand: "WorkflowContentRef";
 };
@@ -55,9 +64,30 @@ export type WorkflowToolCallId = string & {
 export type WorkflowNodeId = string & {
     readonly __brand: "WorkflowNodeId";
 };
+export type WorkflowEdgeId = string & {
+    readonly __brand: "WorkflowEdgeId";
+};
+export type WorkflowNodeCursor = string & {
+    readonly __brand: "WorkflowNodeCursor";
+};
+export type WorkflowEdgeCursor = string & {
+    readonly __brand: "WorkflowEdgeCursor";
+};
 export type WorkflowCommandId = string & {
     readonly __brand: "WorkflowCommandId";
 };
+export type AgentDiagnosticVariableName = string & {
+    readonly __brand: "AgentDiagnosticVariableName";
+};
+export type AgentDiagnosticCheckId = string & {
+    readonly __brand: "AgentDiagnosticCheckId";
+};
+export type AgentDiagnosticSnapshotId = string & {
+    readonly __brand: "AgentDiagnosticSnapshotId";
+};
+export type AgentDiagnosticProbeId = string & {
+    readonly __brand: "AgentDiagnosticProbeId";
+};
 export declare const ProblemDetailsMediaType: "application/problem+json";
 export type ProblemDetailsMediaType = typeof ProblemDetailsMediaType;
 export declare const SortOrderValues: {
@@ -455,6 +485,18 @@ export declare const WorkflowControlStatusValues: {
     readonly failed: "failed";
 };
 export type WorkflowControlStatus = typeof WorkflowControlStatusValues[keyof typeof WorkflowControlStatusValues];
+export declare const WorkflowCursorKindValues: {
+    readonly node: "node";
+    readonly edge: "edge";
+};
+export type WorkflowCursorKind = typeof WorkflowCursorKindValues[keyof typeof WorkflowCursorKindValues];
+export declare const WorkflowCursorFailureReasonValues: {
+    readonly invalid: "invalid";
+    readonly wrongRun: "wrong_run";
+    readonly wrongGeneration: "wrong_generation";
+    readonly stale: "stale";
+};
+export type WorkflowCursorFailureReason = typeof WorkflowCursorFailureReasonValues[keyof typeof WorkflowCursorFailureReasonValues];
 export declare const WorkflowAttemptStatusValues: {
     readonly pending: "pending";
     readonly running: "running";
@@ -480,6 +522,56 @@ export declare const WorkflowToolCallStatusValues: {
     readonly rejected: "rejected";
 };
 export type WorkflowToolCallStatus = typeof WorkflowToolCallStatusValues[keyof typeof WorkflowToolCallStatusValues];
+export declare const AgentDiagnosticValueTypeValues: {
+    readonly null: "null";
+    readonly boolean: "boolean";
+    readonly integer: "integer";
+    readonly number: "number";
+    readonly string: "string";
+    readonly json: "json";
+};
+export type AgentDiagnosticValueType = typeof AgentDiagnosticValueTypeValues[keyof typeof AgentDiagnosticValueTypeValues];
+export declare const AgentDiagnosticClassificationValues: {
+    readonly public: "public";
+    readonly internal: "internal";
+    readonly sensitive: "sensitive";
+    readonly secret: "secret";
+};
+export type AgentDiagnosticClassification = typeof AgentDiagnosticClassificationValues[keyof typeof AgentDiagnosticClassificationValues];
+export declare const AgentDiagnosticOperatorValues: {
+    readonly equal: "equal";
+    readonly notEqual: "not_equal";
+    readonly exists: "exists";
+    readonly typeIs: "type_is";
+    readonly contains: "contains";
+    readonly lessThan: "less_than";
+    readonly greaterThan: "greater_than";
+};
+export type AgentDiagnosticOperator = typeof AgentDiagnosticOperatorValues[keyof typeof AgentDiagnosticOperatorValues];
+export declare const AgentDiagnosticCheckOutcomeValues: {
+    readonly pass: "pass";
+    readonly fail: "fail";
+    readonly unknownResult: "unknown";
+};
+export type AgentDiagnosticCheckOutcome = typeof AgentDiagnosticCheckOutcomeValues[keyof typeof AgentDiagnosticCheckOutcomeValues];
+export declare const AgentDiagnosticExtensionIdValues: {
+    readonly snapshot: "qyl.agent.diagnostic.snapshot";
+};
+export type AgentDiagnosticExtensionId = typeof AgentDiagnosticExtensionIdValues[keyof typeof AgentDiagnosticExtensionIdValues];
+export declare const AgentDiagnosticPhaseValues: {
+    readonly input: "input";
+    readonly output: "output";
+    readonly error: "error";
+    readonly checkpoint: "checkpoint";
+};
+export type AgentDiagnosticPhase = typeof AgentDiagnosticPhaseValues[keyof typeof AgentDiagnosticPhaseValues];
+export declare const AgentDiagnosticOutcomeValues: {
+    readonly pass: "pass";
+    readonly fail: "fail";
+    readonly unknownResult: "unknown";
+    readonly notEvaluated: "not_evaluated";
+};
+export type AgentDiagnosticOutcome = typeof AgentDiagnosticOutcomeValues[keyof typeof AgentDiagnosticOutcomeValues];
 export declare const McpDataModeValues: {
     readonly live: "live";
     readonly demo: "demo";
@@ -510,7 +602,9 @@ export type WorkbenchEvaluationExportPayload = WorkbenchEvaluationJsonExportPayl
 export type WorkbenchProtocolEvents = WorkbenchProtocolEvent;
 export type WorkbenchExecutionUpdateEvents = WorkbenchExecutionRecord;
 export type WorkflowEdgeProvenance = RecordedWorkflowEdgeProvenance | DerivedWorkflowEdgeProvenance;
+export type WorkflowProjectionStatus = CommittedWorkflowProjectionStatus | RebuildingWorkflowProjectionStatus | UnavailableWorkflowProjectionStatus | CorruptWorkflowProjectionStatus;
 export type WorkflowStreamEvents = WorkflowJournalEvent | WorkflowHeartbeatEvent | WorkflowCursorGapEvent;
+export type AgentDiagnosticVariable = CapturedAgentDiagnosticVariable | RedactedAgentDiagnosticVariable | OmittedAgentDiagnosticVariable;
 export type LogEvents = LogStreamEvent | HeartbeatEvent;
 export interface AttributeBytesValue {
     "type": "bytes";
@@ -1355,14 +1449,36 @@ export interface WorkbenchEvaluationExportArtifact {
 export interface WorkbenchEvaluationExportAccepted {
     "export": WorkbenchEvaluationExport;
 }
+export interface CommittedWorkflowProjectionStatus {
+    "state": "committed";
+    "generation": WorkflowGeneration;
+    "journal_position": WorkflowJournalPosition;
+}
+export interface RebuildingWorkflowProjectionStatus {
+    "state": "rebuilding";
+    "generation": WorkflowGeneration;
+    "target_journal_position": WorkflowJournalPosition;
+    "retry_after_ms": number;
+}
+export interface UnavailableWorkflowProjectionStatus {
+    "state": "unavailable";
+    "generation"?: WorkflowGeneration;
+    "retry_after_ms": number;
+}
+export interface CorruptWorkflowProjectionStatus {
+    "state": "corrupt";
+    "generation"?: WorkflowGeneration;
+    "reason": "corrupt_derived_state" | "incompatible_derived_state";
+}
 export interface WorkflowRun {
     "run_id": WorkflowRunId;
+    "generation": WorkflowGeneration;
     "thread_id"?: string;
     "title"?: string;
     "status": WorkflowRunStatus;
     "started_at": string;
     "ended_at"?: string;
-    "latest_journal_sequence": string;
+    "latest_journal_sequence": WorkflowJournalPosition;
     "active_attempt_id"?: WorkflowAttemptId;
     "metadata"?: Record<string, unknown>;
 }
@@ -1375,7 +1491,7 @@ export interface WorkflowRunCreateRequest {
 }
 export interface WorkflowRunPage {
     "items": WorkflowRun[];
-    "next_cursor"?: string;
+    "next_cursor"?: WorkflowRunCursor;
     "has_more": boolean;
 }
 export interface WorkflowContentChunk {
@@ -1408,18 +1524,18 @@ export interface WorkflowEventBatchAppendResponse {
     "accepted_count": number;
     "duplicate_count": number;
     "acknowledged_source_sequence": string;
-    "first_journal_sequence"?: string;
-    "last_journal_sequence"?: string;
+    "first_journal_sequence"?: WorkflowJournalPosition;
+    "last_journal_sequence"?: WorkflowJournalPosition;
 }
 export interface WorkflowJournalEvent extends WorkflowEventAppend {
     "run_id": WorkflowRunId;
     "client_id": string;
-    "journal_sequence": string;
+    "journal_sequence": WorkflowJournalPosition;
 }
 export interface WorkflowEventPage {
     "events": WorkflowJournalEvent[];
-    "next_sequence": string;
-    "high_water_mark": string;
+    "next_sequence": WorkflowJournalPosition;
+    "high_water_mark": WorkflowJournalPosition;
     "cursor_gap": boolean;
 }
 export interface RecordedWorkflowEdgeProvenance {
@@ -1446,7 +1562,7 @@ export interface WorkflowGraphNode {
     "attributes"?: Record<string, unknown>;
 }
 export interface WorkflowGraphEdge {
-    "edge_id": string;
+    "edge_id": WorkflowEdgeId;
     "source_node_id": WorkflowNodeId;
     "target_node_id": WorkflowNodeId;
     "kind": WorkflowEdgeKind;
@@ -1463,12 +1579,13 @@ export interface WorkflowGraphStatistics {
 }
 export interface WorkflowGraphSnapshot {
     "run": WorkflowRun;
+    "projection_status": WorkflowProjectionStatus;
     "nodes": WorkflowGraphNode[];
     "edges": WorkflowGraphEdge[];
     "statistics": WorkflowGraphStatistics;
-    "journal_sequence": string;
-    "next_node_cursor"?: string;
-    "next_edge_cursor"?: string;
+    "journal_sequence": WorkflowJournalPosition;
+    "next_node_cursor"?: WorkflowNodeCursor;
+    "next_edge_cursor"?: WorkflowEdgeCursor;
     "has_more_nodes": boolean;
     "has_more_edges": boolean;
     "total_node_count": number;
@@ -1509,15 +1626,79 @@ export interface WorkflowControlStatusUpdateRequest {
 }
 export interface WorkflowHeartbeatEvent {
     "type": "heartbeat";
-    "high_water_mark": string;
+    "high_water_mark": WorkflowJournalPosition;
     "timestamp": string;
 }
 export interface WorkflowCursorGapEvent {
     "type": "cursor_gap";
-    "oldest_available_sequence": string;
-    "high_water_mark": string;
+    "oldest_available_sequence": WorkflowJournalPosition;
+    "high_water_mark": WorkflowJournalPosition;
     "timestamp": string;
 }
+export interface WorkflowCursorError extends ProblemDetails {
+    "title": "Invalid Workflow Cursor";
+    "cursor_kind": WorkflowCursorKind;
+    "reason": WorkflowCursorFailureReason;
+    "current_generation"?: WorkflowGeneration;
+}
+export interface WorkflowRunDeletedError extends ProblemDetails {
+    "title": "Workflow Run Deleted";
+    "run_id": WorkflowRunId;
+}
+export interface WorkflowProjectionUnavailableError extends ProblemDetails {
+    "title": "Workflow Projection Unavailable";
+    "projection_status": WorkflowProjectionStatus;
+}
+export interface WorkflowProjectionCorruptError extends ProblemDetails {
+    "title": "Workflow Projection Corrupt";
+    "projection_status": WorkflowProjectionStatus;
+}
+export interface AgentDiagnosticVariableBase {
+    "name": AgentDiagnosticVariableName;
+    "type": AgentDiagnosticValueType;
+    "classification": AgentDiagnosticClassification;
+}
+export interface CapturedAgentDiagnosticVariable extends AgentDiagnosticVariableBase {
+    "capture": "value";
+    "value": unknown | null;
+}
+export interface RedactedAgentDiagnosticVariable extends AgentDiagnosticVariableBase {
+    "capture": "redacted";
+}
+export interface OmittedAgentDiagnosticVariable extends AgentDiagnosticVariableBase {
+    "capture": "omitted";
+}
+export interface AgentDiagnosticCheckResult {
+    "check_id": AgentDiagnosticCheckId;
+    "operator": AgentDiagnosticOperator;
+    "actual": AgentDiagnosticVariableName;
+    "expected"?: AgentDiagnosticVariableName;
+    "expected_type"?: AgentDiagnosticValueType;
+    "outcome": AgentDiagnosticCheckOutcome;
+}
+export interface AgentDiagnosticSnapshot {
+    "extension_id": AgentDiagnosticExtensionId;
+    "format_version": number;
+    "snapshot_id": AgentDiagnosticSnapshotId;
+    "capture_nonce": string;
+    "probe_id": AgentDiagnosticProbeId;
+    "phase": AgentDiagnosticPhase;
+    "variables": AgentDiagnosticVariable[];
+    "checks": AgentDiagnosticCheckResult[];
+    "outcome": AgentDiagnosticOutcome;
+}
+export interface AgentDiagnosticSnapshotSummary {
+    "extension_id": AgentDiagnosticExtensionId;
+    "format_version": number;
+    "snapshot_id": AgentDiagnosticSnapshotId;
+    "probe_id": AgentDiagnosticProbeId;
+    "phase": AgentDiagnosticPhase;
+    "outcome": AgentDiagnosticOutcome;
+    "variable_count": number;
+    "check_count": number;
+    "failed_check_count": number;
+    "content_ref": WorkflowContentRef;
+}
 export interface DisplayTracesInput {
     "trace_id"?: TraceId;
     "session_id"?: SessionId;
@@ -1647,22 +1828,57 @@ export interface FetchTelemetryOutput {
     "stats"?: McpDashboardStats;
     "mode": McpDataMode;
 }
+export interface GetActiveWorkflowRunInput {
+}
+export interface GetActiveWorkflowRunOutput {
+    "active": boolean;
+    "live_controls_available": boolean;
+    "run_id"?: WorkflowRunId;
+    "thread_id"?: string;
+    "started_at"?: string;
+}
+export interface RecordDiagnosticSnapshotVariableInput {
+    "name": AgentDiagnosticVariableName;
+    "classification": AgentDiagnosticClassification;
+    "value": unknown | null;
+}
+export interface RecordDiagnosticSnapshotCheckInput {
+    "check_id": AgentDiagnosticCheckId;
+    "operator": AgentDiagnosticOperator;
+    "actual": AgentDiagnosticVariableName;
+    "expected"?: AgentDiagnosticVariableName;
+    "expected_type"?: AgentDiagnosticValueType;
+}
+export interface RecordDiagnosticSnapshotInput {
+    "snapshot_id": AgentDiagnosticSnapshotId;
+    "probe_id": AgentDiagnosticProbeId;
+    "phase": AgentDiagnosticPhase;
+    "variables": RecordDiagnosticSnapshotVariableInput[];
+    "checks"?: RecordDiagnosticSnapshotCheckInput[];
+}
+export interface RecordDiagnosticSnapshotOutput {
+    "recorded": boolean;
+    "code": string;
+    "snapshot_id": AgentDiagnosticSnapshotId;
+    "event_id"?: WorkflowEventId;
+    "field"?: string;
+}
 export interface ListWorkflowRunsInput {
     "status"?: WorkflowRunStatus;
-    "cursor"?: string;
+    "cursor"?: WorkflowRunCursor;
     "limit"?: number;
 }
 export interface ListWorkflowRunsOutput {
     "runs": WorkflowRun[];
-    "next_cursor"?: string;
+    "next_cursor"?: WorkflowRunCursor;
     "has_more": boolean;
     "mode": McpDataMode;
 }
 export interface GetWorkflowGraphInput {
     "run_id": WorkflowRunId;
-    "node_cursor"?: string;
+    "node_cursor"?: WorkflowNodeCursor;
     "node_limit"?: number;
-    "edge_cursor"?: string;
+    "edge_cursor"?: WorkflowEdgeCursor;
     "edge_limit"?: number;
 }
 export interface GetWorkflowGraphOutput {
@@ -1671,9 +1887,9 @@ export interface GetWorkflowGraphOutput {
 }
 export interface DisplayWorkflowGraphInput {
     "run_id"?: WorkflowRunId;
-    "node_cursor"?: string;
+    "node_cursor"?: WorkflowNodeCursor;
     "node_limit"?: number;
-    "edge_cursor"?: string;
+    "edge_cursor"?: WorkflowEdgeCursor;
     "edge_limit"?: number;
 }
 export interface DisplayWorkflowGraphOutput {
@@ -1683,12 +1899,12 @@ export interface DisplayWorkflowGraphOutput {
 }
 export interface FetchWorkflowGraphUpdatesInput {
     "run_id": WorkflowRunId;
-    "after_sequence": string;
+    "after_sequence": WorkflowJournalPosition;
     "limit"?: number;
     "wait_ms"?: number;
-    "node_cursor"?: string;
+    "node_cursor"?: WorkflowNodeCursor;
     "node_limit"?: number;
-    "edge_cursor"?: string;
+    "edge_cursor"?: WorkflowEdgeCursor;
     "edge_limit"?: number;
     "content_ref"?: WorkflowContentRef;
 }
@@ -1698,6 +1914,17 @@ export interface FetchWorkflowGraphUpdatesOutput {
     "content"?: WorkflowContent;
     "mode": McpDataMode;
 }
+export interface InspectWorkflowEventsInput {
+    "run_id": WorkflowRunId;
+    "after_sequence": WorkflowJournalPosition;
+    "limit"?: number;
+    "content_ref"?: WorkflowContentRef;
+}
+export interface InspectWorkflowEventsOutput {
+    "page": WorkflowEventPage;
+    "content"?: WorkflowContent;
+    "mode": McpDataMode;
+}
 export interface ControlWorkflowRunInput {
     "run_id": WorkflowRunId;
     "action": WorkflowControlAction;

package/generated/ts-runtime/api.js

@@ -353,6 +353,16 @@ export const WorkflowControlStatusValues = {
     "rejected": "rejected",
     "failed": "failed",
 };
+export const WorkflowCursorKindValues = {
+    "node": "node",
+    "edge": "edge",
+};
+export const WorkflowCursorFailureReasonValues = {
+    "invalid": "invalid",
+    "wrongRun": "wrong_run",
+    "wrongGeneration": "wrong_generation",
+    "stale": "stale",
+};
 export const WorkflowAttemptStatusValues = {
     "pending": "pending",
     "running": "running",
@@ -375,6 +385,49 @@ export const WorkflowToolCallStatusValues = {
     "failed": "failed",
     "rejected": "rejected",
 };
+export const AgentDiagnosticValueTypeValues = {
+    "null": "null",
+    "boolean": "boolean",
+    "integer": "integer",
+    "number": "number",
+    "string": "string",
+    "json": "json",
+};
+export const AgentDiagnosticClassificationValues = {
+    "public": "public",
+    "internal": "internal",
+    "sensitive": "sensitive",
+    "secret": "secret",
+};
+export const AgentDiagnosticOperatorValues = {
+    "equal": "equal",
+    "notEqual": "not_equal",
+    "exists": "exists",
+    "typeIs": "type_is",
+    "contains": "contains",
+    "lessThan": "less_than",
+    "greaterThan": "greater_than",
+};
+export const AgentDiagnosticCheckOutcomeValues = {
+    "pass": "pass",
+    "fail": "fail",
+    "unknownResult": "unknown",
+};
+export const AgentDiagnosticExtensionIdValues = {
+    "snapshot": "qyl.agent.diagnostic.snapshot",
+};
+export const AgentDiagnosticPhaseValues = {
+    "input": "input",
+    "output": "output",
+    "error": "error",
+    "checkpoint": "checkpoint",
+};
+export const AgentDiagnosticOutcomeValues = {
+    "pass": "pass",
+    "fail": "fail",
+    "unknownResult": "unknown",
+    "notEvaluated": "not_evaluated",
+};
 export const McpDataModeValues = {
     "live": "live",
     "demo": "demo",
@@ -392,4 +445,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:f32216c3a3172ab0";
+export const CONTRACT_REVISION = "sha256:72545708596baccd";

package/index.tsp

@@ -22,6 +22,7 @@ import "./models/health.tsp";
 import "./models/runner.tsp";
 import "./models/workbench.tsp";
 import "./models/workflow.tsp";
+import "./models/diagnostics.tsp";
 import "./models/mcp-tools.tsp";
 
 import "./api/routes.tsp";