@ancplua/qyl-api-schema 7.0.0 → 7.2.0

package/generated/otel-keys.gen.tsp

@@ -1,8 +1,8 @@
 // <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)
-// Schema: https://opentelemetry.io/schemas/1.43.0
+//   open-telemetry/semantic-conventions v1.44.0 (e10a930844c6951757a43b849d364f7d056ac32b)
+//   open-telemetry/semantic-conventions-genai 30182acd5ed78ab5f619041eaec5e95a4eb83a48 (30182acd5ed78ab5f619041eaec5e95a4eb83a48)
+// Schema: https://opentelemetry.io/schemas/1.44.0
 // GenAI schema: https://opentelemetry.io/schemas/gen-ai-dev/1.42.0-dev
 // Licensed under Apache-2.0 (inherited from OpenTelemetry upstream)
 // </auto-generated>
@@ -15,7 +15,7 @@
 namespace Qyl.Telemetry.SemanticConventions.Keys.Android {
   /** This attribute represents the state of the application. */
   const AppState: string = "android.app.state";
-  /** Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). */
+  /** Uniquely identifies the framework API revision offered by a version (`os.version`) of the Android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). */
   const OsApiLevel: string = "android.os.api_level";
   /** Deprecated. Use `android.app.state` attribute instead. */
   #deprecated "Replaced by android.app.state."
@@ -24,7 +24,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Android {
 namespace Qyl.Telemetry.SemanticConventions.Keys.App {
   /** Unique identifier for a particular build or compilation of the application. */
   const BuildId: string = "app.build_id";
-  /** A unique identifier representing an instance of an end-user facing app crash. */
+  /** A unique identifier representing an instance of an end user facing app crash. */
   const CrashId: string = "app.crash.id";
   /** A unique identifier representing the installation of an application on a specific device */
   const InstallationId: string = "app.installation.id";
@@ -52,9 +52,9 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Artifact {
   const AttestationFilename: string = "artifact.attestation.filename";
   /** The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), of the built attestation. Some envelopes in the [software attestation space](https://github.com/in-toto/attestation/tree/main/spec) also refer to this as the **digest**. */
   const AttestationHash: string = "artifact.attestation.hash";
-  /** The id of the build [software attestation](https://slsa.dev/attestation-model). */
+  /** The ID of the build [software attestation](https://slsa.dev/attestation-model). */
   const AttestationId: string = "artifact.attestation.id";
-  /** The human readable file name of the artifact, typically generated during build and release processes. Often includes the package name and version in the file name. */
+  /** The human readable filename of the artifact, typically generated during build and release processes. Often includes the package name and version in the filename. */
   const Filename: string = "artifact.filename";
   /** The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), often found in checksum.txt on a release of the artifact and used to verify package integrity. */
   const Hash: string = "artifact.hash";
@@ -258,6 +258,18 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Browser {
   const Mobile: string = "browser.mobile";
   /** The platform on which the browser is running */
   const Platform: string = "browser.platform";
+  /** The delta between the current value and the last-reported value. See [delta](https://github.com/GoogleChrome/web-vitals?tab=readme-ov-file#report-only-the-delta-of-changes). */
+  const WebVitalDelta: string = "browser.web_vital.delta";
+  /** A unique ID representing this particular metric instance. */
+  const WebVitalId: string = "browser.web_vital.id";
+  /** Name of the web vital. */
+  const WebVitalName: string = "browser.web_vital.name";
+  /** The type of navigation, as reported by the [Navigation Timing API](https://developer.mozilla.org/docs/Web/API/PerformanceNavigationTiming/type), with additional values reported by the web-vitals library. */
+  const WebVitalNavigationType: string = "browser.web_vital.navigation_type";
+  /** The rating of the web vital value against the "good", "needs improvement", and "poor" thresholds defined for the metric. */
+  const WebVitalRating: string = "browser.web_vital.rating";
+  /** Value of the web vital. */
+  const WebVitalValue: string = "browser.web_vital.value";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Cassandra {
   /** The consistency level of the query. Based on consistency values from [CQL](https://docs.datastax.com/en/cassandra-oss/3.0/cassandra/dml/dmlConfigConsistency.html). */
@@ -308,7 +320,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Cicd {
   const WorkerUrlFull: string = "cicd.worker.url.full";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Client {
-  /** Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. */
+  /** Client address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name. */
   const Address: string = "client.address";
   /** Client port number. */
   const Port: string = "client.port";
@@ -369,7 +381,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Code {
   const Column: string = "code.column";
   /** The column number in `code.file.path` best representing the operation. It SHOULD point within the code unit named in `code.function.name`. This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Line'. This constraint is imposed to prevent redundancy and maintain data integrity. */
   const ColumnNumber: string = "code.column.number";
-  /** The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity. */
+  /** The source code filename that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity. */
   const FilePath: string = "code.file.path";
   /** Deprecated, use `code.file.path` instead */
   #deprecated "Replaced by code.file.path."
@@ -410,7 +422,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Container {
   const ImageId: string = "container.image.id";
   /** Name of the image the container was built on. */
   const ImageName: string = "container.image.name";
-  /** Repo digests of the container image as provided by the container runtime. */
+  /** Repository digests of the container image as provided by the container runtime. */
   const ImageRepoDigests: string = "container.image.repo_digests";
   /** Container image tags. An example can be found in [Docker Image Inspect](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Image/operation/ImageInspect). Should be only the `<tag>` section of the full name for example from `registry.example.com/my-org/my-image:<tag>`. */
   const ImageTags: string = "container.image.tags";
@@ -550,7 +562,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Db {
   /** The database query being executed. */
   const QueryText: string = "db.query.text";
   /** Deprecated, use `db.namespace` instead. */
-  #deprecated "Uncategorized."
+  #deprecated "Replaced by `db.namespace` (string)."
   const RedisDatabaseIndex: string = "db.redis.database_index";
   /** Number of rows returned by the operation. */
   const ResponseReturnedRows: string = "db.response.returned_rows";
@@ -579,7 +591,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Deployment {
   const Environment: string = "deployment.environment";
   /** Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier). */
   const EnvironmentName: string = "deployment.environment.name";
-  /** The id of the deployment. */
+  /** The ID of the deployment. */
   const Id: string = "deployment.id";
   /** The name of the deployment. */
   const Name: string = "deployment.name";
@@ -587,7 +599,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Deployment {
   const Status: string = "deployment.status";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Destination {
-  /** Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. */
+  /** Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name. */
   const Address: string = "destination.address";
   /** Destination port number */
   const Port: string = "destination.port";
@@ -755,7 +767,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.File {
   const OwnerId: string = "file.owner.id";
   /** Username of the file owner. */
   const OwnerName: string = "file.owner.name";
-  /** Full path to the file, including the file name. It should include the drive letter, when appropriate. */
+  /** Full path to the file, including the filename. It should include the drive letter, when appropriate. */
   const Path: string = "file.path";
   /** File size in bytes. */
   const Size: string = "file.size";
@@ -891,6 +903,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 +917,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. */
@@ -1011,7 +1027,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Host {
   const Ip: string = "host.ip";
   /** Available MAC addresses of the host, excluding loopback interfaces. */
   const Mac: string = "host.mac";
-  /** Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. */
+  /** Name of the host. On UNIX systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. */
   const Name: string = "host.name";
   /** Type of host. For Cloud, this must be the machine type. */
   const Type: string = "host.type";
@@ -1435,17 +1451,19 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Messaging {
   const EventhubsMessageEnqueuedTime: string = "messaging.eventhubs.message.enqueued_time";
   /** The ack deadline in seconds set for the modify ack deadline request. */
   const GcpPubsubMessageAckDeadline: string = "messaging.gcp_pubsub.message.ack_deadline";
-  /** The ack id for a given message. */
+  /** The ack ID for a given message. */
   const GcpPubsubMessageAckId: string = "messaging.gcp_pubsub.message.ack_id";
   /** The delivery attempt for a given message. */
   const GcpPubsubMessageDeliveryAttempt: string = "messaging.gcp_pubsub.message.delivery_attempt";
   /** The ordering key for a given message. If the attribute is not present, the message does not have an ordering key. */
   const GcpPubsubMessageOrderingKey: string = "messaging.gcp_pubsub.message.ordering_key";
+  /** The Kafka cluster ID, obtained from the broker metadata exposed through the Kafka client (or AdminClient) API. */
+  const KafkaClusterId: string = "messaging.kafka.cluster.id";
   /** Deprecated, use `messaging.consumer.group.name` instead. */
   #deprecated "Replaced by messaging.consumer.group.name."
   const KafkaConsumerGroup: string = "messaging.kafka.consumer.group";
   /** Deprecated, use `messaging.destination.partition.id` instead. */
-  #deprecated "Record string representation of the partition id in `messaging.destination.partition.id` attribute."
+  #deprecated "Record string representation of the partition ID in `messaging.destination.partition.id` attribute."
   const KafkaDestinationPartition: string = "messaging.kafka.destination.partition";
   /** Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ from `messaging.message.id` in that they're not unique. If the key is `null`, the attribute MUST NOT be set. */
   const KafkaMessageKey: string = "messaging.kafka.message.key";
@@ -1486,7 +1504,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Messaging {
   const RocketmqMessageDeliveryTimestamp: string = "messaging.rocketmq.message.delivery_timestamp";
   /** It is essential for FIFO message. Messages that belong to the same message group are always processed one by one within the same consumer group. */
   const RocketmqMessageGroup: string = "messaging.rocketmq.message.group";
-  /** Key(s) of message, another way to mark message besides message id. */
+  /** Key(s) of message, another way to mark message besides message ID. */
   const RocketmqMessageKeys: string = "messaging.rocketmq.message.keys";
   /** The secondary classifier of message besides topic. */
   const RocketmqMessageTag: string = "messaging.rocketmq.message.tag";
@@ -1564,7 +1582,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Network {
   const CarrierName: string = "network.carrier.name";
   /** The state of network connection */
   const ConnectionState: string = "network.connection.state";
-  /** This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. */
+  /** This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a Wi-Fi connection. */
   const ConnectionSubtype: string = "network.connection.subtype";
   /** The internet connection type. */
   const ConnectionType: string = "network.connection.type";
@@ -1572,11 +1590,11 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Network {
   const InterfaceName: string = "network.interface.name";
   /** The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. */
   const IoDirection: string = "network.io.direction";
-  /** Local address of the network connection - IP address or Unix domain socket name. */
+  /** Local address of the network connection - IP address or UNIX domain socket name. */
   const LocalAddress: string = "network.local.address";
   /** Local port number of the network connection. */
   const LocalPort: string = "network.local.port";
-  /** Peer address of the network connection - IP address or Unix domain socket name. */
+  /** Peer address of the network connection - IP address or UNIX domain socket name. */
   const PeerAddress: string = "network.peer.address";
   /** Peer port number of the network connection. */
   const PeerPort: string = "network.peer.port";
@@ -1714,9 +1732,9 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Pprof {
   const ProfileComment: string = "pprof.profile.comment";
   /** Documentation link for this profile type. */
   const ProfileDocUrl: string = "pprof.profile.doc_url";
-  /** Frames with Function.function_name fully matching the regexp will be dropped from the samples, along with their successors. */
+  /** Frames with Function.function_name fully matching the regular expression will be dropped from the samples, along with their successors. */
   const ProfileDropFrames: string = "pprof.profile.drop_frames";
-  /** Frames with Function.function_name fully matching the regexp will be kept, even if it matches drop_frames. */
+  /** Frames with Function.function_name fully matching the regular expression will be kept, even if it matches drop_frames. */
   const ProfileKeepFrames: string = "pprof.profile.keep_frames";
   /** Records the pprof's default_sample_type in the original profile. Not set if the default sample type was missing. */
   const ScopeDefaultSampleType: string = "pprof.scope.default_sample_type";
@@ -1887,7 +1905,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.SecurityRule {
   const Version: string = "security_rule.version";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Server {
-  /** Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. */
+  /** Server domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name. */
   const Address: string = "server.address";
   /** Server port number. */
   const Port: string = "server.port";
@@ -1909,7 +1927,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Service {
   const Version: string = "service.version";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Session {
-  /** A unique id to identify a session. */
+  /** A unique ID to identify a session. */
   const Id: string = "session.id";
   /** The previous `session.id` for this user, when known. */
   const PreviousId: string = "session.previous_id";
@@ -1921,7 +1939,7 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Signalr {
   const Transport: string = "signalr.transport";
 }
 namespace Qyl.Telemetry.SemanticConventions.Keys.Source {
-  /** Source address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. */
+  /** Source address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name. */
   const Address: string = "source.address";
   /** Source port number */
   const Port: string = "source.port";
@@ -2079,11 +2097,11 @@ namespace Qyl.Telemetry.SemanticConventions.Keys.Url {
   const Port: string = "url.port";
   /** The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component */
   const Query: string = "url.query";
-  /** The highest registered url domain, stripped of the subdomain. */
+  /** The highest registered URL domain, stripped of the subdomain. */
   const RegisteredDomain: string = "url.registered_domain";
   /** The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. */
   const Scheme: string = "url.scheme";
-  /** The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. */
+  /** The subdomain portion of a fully qualified domain name includes all of the names except the hostname under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. */
   const Subdomain: string = "url.subdomain";
   /** The low-cardinality template of an [absolute path reference](https://www.rfc-editor.org/rfc/rfc3986#section-4.2). */
   const Template: string = "url.template";

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:1b1277a75d8c80e7";

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";