@ancplua/qyl-api-schema 7.0.0 → 7.1.0

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

@@ -76,6 +76,18 @@ export type WorkflowEdgeCursor = string & {
 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: {
@@ -510,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";
@@ -542,6 +604,7 @@ 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";
@@ -1590,6 +1653,52 @@ 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;
@@ -1719,6 +1828,41 @@ 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"?: WorkflowRunCursor;
@@ -1770,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

@@ -385,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",
@@ -402,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:53278018c62ed547";
+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";

package/models/diagnostics.tsp

@@ -0,0 +1,204 @@
+import "./workflow.tsp";
+
+using Qyl.Api.Contracts.Workflow;
+
+namespace Qyl.Api.Contracts.Diagnostics;
+
+@doc("The versioned extension discriminator for a protected agent diagnostic snapshot.")
+enum AgentDiagnosticExtensionId {
+  snapshot: "qyl.agent.diagnostic.snapshot",
+}
+
+@doc("Wire-format version of an agent diagnostic snapshot. Version 1 is the only accepted format.")
+@minValue(1)
+@maxValue(1)
+scalar AgentDiagnosticFormatVersion extends int32;
+
+@doc("Stable machine identifier of one diagnostic snapshot. This identifier is a value and must never be promoted to a telemetry key.")
+@pattern("^[A-Za-z0-9_][A-Za-z0-9._:/\\[\\]-]{0,127}$")
+@minLength(1)
+@maxLength(128)
+scalar AgentDiagnosticSnapshotId extends string;
+
+@doc("Stable machine identifier of the probe that captured a diagnostic snapshot. This identifier is a value and must never be promoted to a telemetry key.")
+@pattern("^[A-Za-z0-9_][A-Za-z0-9._:/\\[\\]-]{0,127}$")
+@minLength(1)
+@maxLength(128)
+scalar AgentDiagnosticProbeId extends string;
+
+@doc("Stable machine identifier of one diagnostic check. This identifier is a value and must never be promoted to a telemetry key.")
+@pattern("^[A-Za-z0-9_][A-Za-z0-9._:/\\[\\]-]{0,127}$")
+@minLength(1)
+@maxLength(128)
+scalar AgentDiagnosticCheckId extends string;
+
+@doc("Stable machine name of one dynamically captured variable. Names are data values, never telemetry attribute keys, event names, or span names.")
+@pattern("^[A-Za-z0-9_][A-Za-z0-9._:/\\[\\]-]{0,127}$")
+@minLength(1)
+@maxLength(128)
+scalar AgentDiagnosticVariableName extends string;
+
+@doc("Execution boundary at which the state frame was captured.")
+enum AgentDiagnosticPhase {
+  input: "input",
+  output: "output",
+  error: "error",
+  checkpoint: "checkpoint",
+}
+
+@doc("Machine-computed aggregate result of a diagnostic snapshot. unknown reports one or more unknown check outcomes. not_evaluated is reserved for a snapshot whose checks array is empty.")
+enum AgentDiagnosticOutcome {
+  pass: "pass",
+  fail: "fail",
+  unknownResult: "unknown",
+  notEvaluated: "not_evaluated",
+}
+
+@doc("Machine-computed result of one diagnostic check. For exists, an absent or null actual variable produces fail. For every other operator, missing required operands produce unknown; incompatible operand types also produce unknown. not_evaluated is deliberately not a check outcome.")
+enum AgentDiagnosticCheckOutcome {
+  pass: "pass",
+  fail: "fail",
+  unknownResult: "unknown",
+}
+
+@doc("Declared JSON-level type of a diagnostic variable.")
+enum AgentDiagnosticValueType {
+  null: "null",
+  boolean: "boolean",
+  integer: "integer",
+  number: "number",
+  string: "string",
+  json: "json",
+}
+
+@doc("Data-handling classification assigned before a diagnostic variable is captured.")
+enum AgentDiagnosticClassification {
+  public: "public",
+  internal: "internal",
+  sensitive: "sensitive",
+  secret: "secret",
+}
+
+@doc("Closed operation evaluated by a diagnostic check. Checks are structural and never carry expression strings.")
+enum AgentDiagnosticOperator {
+  equal: "equal",
+  notEqual: "not_equal",
+  exists: "exists",
+  typeIs: "type_is",
+  contains: "contains",
+  lessThan: "less_than",
+  greaterThan: "greater_than",
+}
+
+@doc("Common identity and policy fields for one dynamic diagnostic variable.")
+model AgentDiagnosticVariableBase {
+  name: AgentDiagnosticVariableName;
+  type: AgentDiagnosticValueType;
+  classification: AgentDiagnosticClassification;
+}
+
+@doc("A variable whose typed JSON value is present in protected snapshot content. The value is required and must match type: null is JSON null; boolean is a JSON boolean; integer is a signed 64-bit JSON integer; number is a finite JSON number; string is a JSON string; json is a JSON object or array. The protected content boundary, not this model, controls access to all captured values.")
+model CapturedAgentDiagnosticVariable extends AgentDiagnosticVariableBase {
+  capture: "value";
+  value: unknown | null;
+}
+
+@doc("A variable observed by the probe whose value was replaced by policy. A value field is forbidden.")
+model RedactedAgentDiagnosticVariable extends AgentDiagnosticVariableBase {
+  capture: "redacted";
+}
+
+@doc("A variable whose value was unavailable or deliberately not captured. A value field is forbidden.")
+model OmittedAgentDiagnosticVariable extends AgentDiagnosticVariableBase {
+  capture: "omitted";
+}
+
+@doc("One dynamically named variable in a protected diagnostic snapshot. Capture is the discriminator and makes value presence unambiguous.")
+union AgentDiagnosticVariable {
+  value: CapturedAgentDiagnosticVariable,
+  redacted: RedactedAgentDiagnosticVariable,
+  omitted: OmittedAgentDiagnosticVariable,
+}
+
+@doc("One structural, machine-computed check result. actual and expected reference variable names only. For equal, not_equal, contains, less_than, and greater_than, expected is required and expected_type is omitted. For exists, both are omitted and an absent or null actual variable produces fail. For type_is, expected is omitted and expected_type is required. For operators other than exists, missing required operands produce unknown; incompatible operand types also produce unknown. not_evaluated is reserved for the snapshot aggregate when checks is empty and is not emitted for an individual check.")
+model AgentDiagnosticCheckResult {
+  @encodedName("application/json", "check_id")
+  checkId: AgentDiagnosticCheckId;
+
+  operator: AgentDiagnosticOperator;
+  actual: AgentDiagnosticVariableName;
+  expected?: AgentDiagnosticVariableName;
+
+  @encodedName("application/json", "expected_type")
+  expectedType?: AgentDiagnosticValueType;
+
+  outcome: AgentDiagnosticCheckOutcome;
+}
+
+@doc("Version 1 protected JSON state frame captured for an artificial-intelligence agent. extension_id and format_version are its schema identity. capture_nonce is fresh entropy and is not a stable identifier. Variables and checks are bounded, dynamic names remain values, and no human-oriented message or expression text is part of the contract. Overall outcome is not_evaluated only when checks is empty. For a non-empty checks array it is fail if any check fails, otherwise unknown if any check is unknown, otherwise pass.")
+model AgentDiagnosticSnapshot {
+  @encodedName("application/json", "extension_id")
+  extensionId: AgentDiagnosticExtensionId;
+
+  @encodedName("application/json", "format_version")
+  formatVersion: AgentDiagnosticFormatVersion;
+
+  @encodedName("application/json", "snapshot_id")
+  snapshotId: AgentDiagnosticSnapshotId;
+
+  @doc("Fresh 128-bit random nonce encoded as exactly 32 lowercase hexadecimal characters. It prevents equality inference across otherwise identical protected captures and must not be used as an identity key.")
+  @encodedName("application/json", "capture_nonce")
+  @pattern("^[0-9a-f]{32}$")
+  @minLength(32)
+  @maxLength(32)
+  captureNonce: string;
+
+  @encodedName("application/json", "probe_id")
+  probeId: AgentDiagnosticProbeId;
+
+  phase: AgentDiagnosticPhase;
+
+  @maxItems(64)
+  variables: AgentDiagnosticVariable[];
+
+  @maxItems(64)
+  checks: AgentDiagnosticCheckResult[];
+
+  outcome: AgentDiagnosticOutcome;
+}
+
+@doc("Value-free event-data projection for a protected agent diagnostic snapshot. Encode this shape in WorkflowEventAppend.data on the existing content_captured event kind. content_ref must also occur in that event's content_refs and identifies UTF-8 JSON conforming to AgentDiagnosticSnapshot. Counts are computed from the referenced snapshot; failed_check_count counts checks whose outcome is fail. No variable names, values, human messages, expressions, nonce, or classifications may appear in this summary.")
+model AgentDiagnosticSnapshotSummary {
+  @encodedName("application/json", "extension_id")
+  extensionId: AgentDiagnosticExtensionId;
+
+  @encodedName("application/json", "format_version")
+  formatVersion: AgentDiagnosticFormatVersion;
+
+  @encodedName("application/json", "snapshot_id")
+  snapshotId: AgentDiagnosticSnapshotId;
+
+  @encodedName("application/json", "probe_id")
+  probeId: AgentDiagnosticProbeId;
+
+  phase: AgentDiagnosticPhase;
+  outcome: AgentDiagnosticOutcome;
+
+  @encodedName("application/json", "variable_count")
+  @minValue(0)
+  @maxValue(64)
+  variableCount: int32;
+
+  @encodedName("application/json", "check_count")
+  @minValue(0)
+  @maxValue(64)
+  checkCount: int32;
+
+  @encodedName("application/json", "failed_check_count")
+  @minValue(0)
+  @maxValue(64)
+  failedCheckCount: int32;
+
+  @encodedName("application/json", "content_ref")
+  contentRef: WorkflowContentRef;
+}

package/models/mcp-tools.tsp

@@ -1,10 +1,12 @@
 import "../common/types.tsp";
 import "../otel/logs.tsp";
 import "../otel/span.tsp";
+import "./diagnostics.tsp";
 import "./session.tsp";
 import "./workflow.tsp";
 
 using Qyl.Api.Contracts.Common;
+using Qyl.Api.Contracts.Diagnostics;
 using Qyl.Api.Contracts.Domains.Observe.Session;
 using Qyl.Api.Contracts.OTel.Logs;
 using Qyl.Api.Contracts.OTel.Traces;
@@ -218,6 +220,77 @@ model FetchTelemetryOutput {
   mode: McpDataMode;
 }
 
+@doc("Input for get_active_workflow_run.")
+model GetActiveWorkflowRunInput {}
+
+@doc("Structured output for get_active_workflow_run.")
+model GetActiveWorkflowRunOutput {
+  active: boolean;
+
+  @encodedName("application/json", "live_controls_available")
+  liveControlsAvailable: boolean;
+
+  @encodedName("application/json", "run_id")
+  runId?: WorkflowRunId;
+
+  @encodedName("application/json", "thread_id")
+  threadId?: string;
+
+  @encodedName("application/json", "started_at")
+  startedAt?: utcDateTime;
+}
+
+@doc("One dynamically named JSON value submitted for protected diagnostic capture. Classification is applied before the frame leaves the observer bridge.")
+model RecordDiagnosticSnapshotVariableInput {
+  name: AgentDiagnosticVariableName;
+  classification: AgentDiagnosticClassification;
+  value: unknown | null;
+}
+
+@doc("One structural diagnostic check submitted for evaluation. equal, not_equal, contains, less_than, and greater_than require expected and forbid expected_type; type_is requires expected_type and forbids expected; exists forbids both.")
+model RecordDiagnosticSnapshotCheckInput {
+  @encodedName("application/json", "check_id")
+  checkId: AgentDiagnosticCheckId;
+
+  operator: AgentDiagnosticOperator;
+  actual: AgentDiagnosticVariableName;
+  expected?: AgentDiagnosticVariableName;
+
+  @encodedName("application/json", "expected_type")
+  expectedType?: AgentDiagnosticValueType;
+}
+
+@doc("Input for record_diagnostic_snapshot. Reuse the same snapshot_id and semantic payload when retrying; changing the payload under an existing snapshot_id is a conflict.")
+model RecordDiagnosticSnapshotInput {
+  @encodedName("application/json", "snapshot_id")
+  snapshotId: AgentDiagnosticSnapshotId;
+
+  @encodedName("application/json", "probe_id")
+  probeId: AgentDiagnosticProbeId;
+
+  phase: AgentDiagnosticPhase;
+
+  @maxItems(64)
+  variables: RecordDiagnosticSnapshotVariableInput[];
+
+  @maxItems(64)
+  checks?: RecordDiagnosticSnapshotCheckInput[] = #[];
+}
+
+@doc("Structured output for record_diagnostic_snapshot.")
+model RecordDiagnosticSnapshotOutput {
+  recorded: boolean;
+  code: string;
+
+  @encodedName("application/json", "snapshot_id")
+  snapshotId: AgentDiagnosticSnapshotId;
+
+  @encodedName("application/json", "event_id")
+  eventId?: WorkflowEventId;
+
+  field?: string;
+}
+
 @doc("Input for list_workflow_runs.")
 model ListWorkflowRunsInput {
   status?: WorkflowRunStatus;
@@ -354,6 +427,30 @@ model FetchWorkflowGraphUpdatesOutput {
   mode: McpDataMode;
 }
 
+@doc("Input for inspect_workflow_events.")
+model InspectWorkflowEventsInput {
+  @encodedName("application/json", "run_id")
+  runId: WorkflowRunId;
+
+  @encodedName("application/json", "after_sequence")
+  afterSequence: WorkflowJournalPosition;
+
+  @minValue(1)
+  @maxValue(1000)
+  limit?: int32 = 250;
+
+  @doc("Optional captured payload to retrieve lazily for the selected run.")
+  @encodedName("application/json", "content_ref")
+  contentRef?: WorkflowContentRef;
+}
+
+@doc("Structured output for inspect_workflow_events.")
+model InspectWorkflowEventsOutput {
+  page: WorkflowEventPage;
+  content?: WorkflowContent;
+  mode: McpDataMode;
+}
+
 @doc("Input for control_workflow_run.")
 model ControlWorkflowRunInput {
   @encodedName("application/json", "run_id")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "TypeSpec source of truth for qyl API contracts. Emits OpenAPI, JSON Schema, Qyl.Api.Contracts DTOs, and TypeScript contract types; not an OpenTelemetry package, storage schema, or server implementation.",
   "license": "Apache-2.0",
   "repository": {
@@ -62,6 +62,7 @@
     "models/runner.tsp",
     "models/workbench.tsp",
     "models/workflow.tsp",
+    "models/diagnostics.tsp",
     "models/mcp-tools.tsp",
     "models/session.tsp",
     "otel/enums.tsp",
@@ -87,10 +88,11 @@
     "build:emitters": "tsc -p emitters/csharp && tsc -p emitters/ts-types && tsc -p emitters/qyl-lint",
     "build:ts-runtime": "tsc -p tsconfig.contracts.json",
     "build:json-schema": "node scripts/openapi-to-json-schema.mjs",
+    "emit:mcp-tool-schemas": "node scripts/emit-mcp-tool-schemas.mjs",
     "emit:contract-revision": "node scripts/emit-contract-revision.mjs",
     "prepare": "npm run build:emitters",
     "prepack": "npm run compile",
-    "compile": "npm run clean:generated && npm run build:emitters && tsp compile main.tsp && npm run emit:contract-revision && npm run build:json-schema && npm run build:ts-runtime",
+    "compile": "npm run clean:generated && npm run build:emitters && tsp compile main.tsp && npm run emit:contract-revision && npm run build:json-schema && npm run emit:mcp-tool-schemas && npm run build:ts-runtime",
     "format": "tsp format **/*.tsp",
     "lint": "npm run build:emitters && tsp compile main.tsp --no-emit --warn-as-error",
     "lint:public": "npm run build:emitters && tsp compile index.tsp --no-emit --warn-as-error",
@@ -100,11 +102,11 @@
   },
   "peerDependencies": {
     "@typespec/compiler": "^1.13.0 || >=1.13.0-dev.0",
-    "@typespec/events": "^0.83.0 || ^0.84.0",
+    "@typespec/events": "^0.83.0 || ^0.84.0 || ^0.85.0",
     "@typespec/http": "^1.13.0",
     "@typespec/openapi": "^1.13.0",
     "@typespec/openapi3": "^1.13.0",
-    "@typespec/sse": ">=0.83.0 <0.85.0"
+    "@typespec/sse": ">=0.83.0 <0.86.0"
   },
   "peerDependenciesMeta": {
     "@typespec/compiler": {