executionProvenanceSchema

const executionProvenanceSchema: object

The JSON Schemas those models were generated from, for runtime use.

Type Declaration

$id

readonly $id: "https://schemas.inderun.dev/1.0/execution-provenance.schema.json"

$schema

readonly $schema: "https://json-schema.org/draft/2020-12/schema"

additionalProperties

readonly additionalProperties: true

description

readonly description: "Provider-neutral record of how an execution was carried out: the target the outcome is attributed to, its declared locality, the configured and provider-reported model, every attempt, and why other candidates were rejected. Carried on TaskResult, on every StreamTerminalOutcome branch, and on IndeRunError. It reports what the engine observed and what providers declared or reported; it never infers a model or locality a provider did not state, and it never contains request content, credentials, or provider payloads."

properties

readonly properties: object

properties.attemptCount

readonly attemptCount: object

properties.attemptCount.description

readonly description: "How many providers were attempted. 0 when the request failed validation or routing, or was cancelled before any attempt started."

properties.attemptCount.minimum

readonly minimum: 0

properties.attemptCount.type

readonly type: "integer"

properties.attempts

readonly attempts: object

properties.attempts.description

readonly description: "Every attempted provider, in attempt order, with how its attempt ended."

properties.attempts.items

readonly items: object

properties.attempts.items.additionalProperties

readonly additionalProperties: true

properties.attempts.items.properties

readonly properties: object

properties.attempts.items.properties.committed

readonly committed: object

properties.attempts.items.properties.committed.description

readonly description: "Whether the run committed to this provider during the attempt: its first content was delivered, it signalled the first possible audible effect, or it handed over an artifact. After commit a failure ends the run instead of falling back. Absent means the attempt did not commit."

properties.attempts.items.properties.committed.type

readonly type: "boolean"

properties.attempts.items.properties.errorClass

readonly errorClass: object

properties.attempts.items.properties.errorClass.description

readonly description: "Normalized error class of a failed attempt."

properties.attempts.items.properties.errorClass.enum

readonly enum: readonly ["CapabilityMismatch", "Offline", "AuthError", "RateLimited", "Timeout", "Unavailable", "Internal"]

properties.attempts.items.properties.outcome

readonly outcome: object

properties.attempts.items.properties.outcome.description

readonly description: "'succeeded' (produced the result or was committed to and completed), 'failed', or 'cancelled'."

properties.attempts.items.properties.outcome.enum

readonly enum: readonly ["succeeded", "failed", "cancelled"]

properties.attempts.items.properties.outcome.title

readonly title: "AttemptOutcome"

properties.attempts.items.properties.providerId

readonly providerId: object

properties.attempts.items.properties.providerId.minLength

readonly minLength: 1

properties.attempts.items.properties.providerId.type

readonly type: "string"

properties.attempts.items.required

readonly required: readonly ["providerId", "outcome"]

properties.attempts.items.title

readonly title: "ExecutionProvenanceAttempt"

properties.attempts.items.type

readonly type: "object"

properties.attempts.type

readonly type: "array"

properties.configuredModel

readonly configuredModel: object

properties.configuredModel.description

readonly description: "The model providerId is bound to, as its descriptor declares it. Absent when the provider cannot name its model or no provider is attributed."

properties.configuredModel.minLength

readonly minLength: 1

properties.configuredModel.type

readonly type: "string"

properties.fallbackOccurred

readonly fallbackOccurred: object

properties.fallbackOccurred.description

readonly description: "Whether more than one provider was attempted (attemptCount > 1)."

properties.fallbackOccurred.type

readonly type: "boolean"

properties.locality

readonly locality: object

properties.locality.description

readonly description: "Where providerId declares it executes: 'on_device' for a local provider, 'edge', or 'cloud'. A declaration by the provider's descriptor, not a measurement. 'unknown' when providerId is absent."

properties.locality.enum

readonly enum: readonly ["on_device", "edge", "cloud", "unknown"]

properties.modelProfile

readonly modelProfile: object

properties.modelProfile.description

readonly description: "The model profile the request routed within; 'auto' when the request named none."

properties.modelProfile.minLength

readonly minLength: 1

properties.modelProfile.type

readonly type: "string"

properties.providerId

readonly providerId: object

properties.providerId.description

readonly description: "The target the outcome is attributed to: the provider that produced the result, the provider a stream had committed to when it ended, or the provider that was running when it was cancelled. Absent when no provider was reached or when every attempted provider failed before one was committed to."

properties.providerId.minLength

readonly minLength: 1

properties.providerId.type

readonly type: "string"

properties.reportedModel

readonly reportedModel: object

properties.reportedModel.description

readonly description: "The model identifier the provider reported in its own response. Absent means the provider did not report one; it is never inferred from configuration."

properties.reportedModel.minLength

readonly minLength: 1

properties.reportedModel.type

readonly type: "string"

properties.routeRejections

readonly routeRejections: object

properties.routeRejections.description

readonly description: "Providers the route planner rejected before any attempt, with the normalized RoutePlan reason codes. Codes only: no provider-supplied messages."

properties.routeRejections.items

readonly items: object

properties.routeRejections.items.additionalProperties

readonly additionalProperties: true

properties.routeRejections.items.properties

readonly properties: object

properties.routeRejections.items.properties.codes

readonly codes: object

properties.routeRejections.items.properties.codes.items

readonly items: object

properties.routeRejections.items.properties.codes.items.enum

readonly enum: readonly ["task_not_supported", "run_not_supported", "streaming_not_supported", "streaming_unavailable", "privacy_constraint", "cloud_constraint", "offline", "capability_unavailable", "not_in_model_profile", "input_not_supported", "output_delivery_not_supported", "output_format_not_supported", "locale_not_supported", "voice_not_available", "prepare_not_supported", "not_ready"]

properties.routeRejections.items.properties.codes.type

readonly type: "array"

properties.routeRejections.items.properties.providerId

readonly providerId: object

properties.routeRejections.items.properties.providerId.minLength

readonly minLength: 1

properties.routeRejections.items.properties.providerId.type

readonly type: "string"

properties.routeRejections.items.required

readonly required: readonly ["providerId", "codes"]

properties.routeRejections.items.title

readonly title: "ExecutionProvenanceRouteRejection"

properties.routeRejections.items.type

readonly type: "object"

properties.routeRejections.type

readonly type: "array"

properties.schemaVersion

readonly schemaVersion: object

properties.schemaVersion.const

readonly const: "1.0"

properties.schemaVersion.description

readonly description: "Contract schema version used to interpret this provenance record."

required

readonly required: readonly ["schemaVersion", "modelProfile", "locality", "attemptCount", "fallbackOccurred", "attempts", "routeRejections"]

title

readonly title: "ExecutionProvenance"

type

readonly type: "object"