> For the complete documentation index, see [llms.txt](https://docs.kognitos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kognitos.com/guides/api-reference/runs.md).

# Runs

Execute automations and manage run lifecycle — start, pause, continue, and view events.

## GET /api/v1/organizations/{organization\_id}/workspaces/{workspace\_id}/automations/{automation\_id}/runs/{run\_id}

> Get Run

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1Run":{"type":"object","properties":{"name":{"type":"string","title":"The name of the run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"executable_steps":{"$ref":"#/components/schemas/v1ExecutableSteps"},"create_time":{"type":"string","format":"date-time","description":"The timestamp when this run was created.\nSet automatically when the run is first submitted to the system.","readOnly":true},"state":{"$ref":"#/components/schemas/v1RunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when this run was updated.\nSet automatically when the run is updated.","readOnly":true},"previous_run":{"type":"string","title":"The name of the previous run in the chain, if applicable.\nExecution details of the previous run may be used to avoid re-computation.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"stage_version":{"type":"string","description":"The version of the automation stage at the time this run was created."},"invocation_details":{"$ref":"#/components/schemas/v1InvocationDetails"},"user_inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The user inputs provided to the run during pre phase and will be available for the UI to display the user inputs."},"root_run":{"type":"string","title":"The first run in this run's replay lineage. A run created fresh is its own\nroot; a run created by ReplayRun shares its source run's root. Lets a whole\nreplay lineage be fetched in one query (ListRuns filtered by root_run), and\ntop-level runs be listed by filtering for an empty previous_run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}","readOnly":true},"disable_exception_handling":{"type":"boolean","description":"Whether to disable exception creation and handling when this run encounters guidance\nand enters the Awaiting Guidance state.\nApplies only to draft-stage runs. Published-stage runs always use standard Astral exception handling."},"enable_astral_on_rain":{"type":"boolean","description":"Whether exception handling should be performed by the Astral agent deployed\non the Rain agent framework."},"active_step_index":{"type":"integer","format":"int32","description":"The zero-based index of the step currently executing within executable_steps.\nAbsent when executable_steps is empty (single-step runs without a pre-phase).","readOnly":true},"archived_time":{"type":"string","format":"date-time","description":"The timestamp when this run was archived, if it has been archived.\nWhen set, the run cannot be mutated (pause, resume, skip, patch, retry).\nThe state field continues to reflect the real terminal execution state.","readOnly":true},"content_coverage":{"$ref":"#/components/schemas/v1RunContentCoverage"}},"description":"Run represents a single execution instance of code in the Jeeves platform.\nContains the executable code, metadata, and current execution state.","required":["stage","stage_version"]},"v1ExecutableSteps":{"type":"object","properties":{"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Input parameters for the execution, provided as name-value pairs.\nThese variables will be available to the code during execution."},"executables":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutableStep"},"description":"The source code to be executed, written in SPy (Simplified Python) language."}},"description":"ExecutableSteps represents a sequence of steps of execution of a run. Each step is\na separate computable unit with its own code, book connections and optional inputs.\nThe first step may optionally have an input provided to it when the run is invoked.\nThe output of each step becomes the input of the next step and the output of the\nlast step becomes the output of the run.","required":["executables"]},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1ExecutableStep":{"type":"object","properties":{"code":{"type":"string","description":"The source code to be executed, written in SPy (Simplified Python) language.\nThis is the main logic that will be interpreted and run by the execution engine."},"book_connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections required by this executable.\nMaps connection names to their specific ID and endpoints."},"phase_type":{"$ref":"#/components/schemas/v1AutomationPhaseType"},"collections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1CollectionRef"},"description":"Collections referenced by this step.\nMaps each collection slug to its reference."},"index":{"type":"integer","format":"int32","description":"Zero-based position of this step within executable_steps.","readOnly":true},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Business-tunable config for this step, keyed by config name and resolved to\nplain values. Read in SPy as kognitos.config.<name>."}},"description":"ExecutableStep represents a piece of code that can be executed in the Jeeves platform.\nContains the source code, input parameters, and external dependencies needed for execution.","required":["code","phase_type"]},"v1BookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"Unique identifier for this connection resource."},"endpoint":{"type":"string","description":"Endpoint for the connection."}},"description":"BookConnection is a resource representing a connection to a book instance.\nA connection has a unique identifier and an endpoint."},"v1AutomationPhaseType":{"type":"string","enum":["AUTOMATION_PHASE_TYPE_UNSPECIFIED","AUTOMATION_PHASE_TYPE_PRE","AUTOMATION_PHASE_TYPE_MAIN","AUTOMATION_PHASE_TYPE_POST"],"default":"AUTOMATION_PHASE_TYPE_UNSPECIFIED","description":"PhaseType defines the type of phase for an automation trigger.\n\n - AUTOMATION_PHASE_TYPE_UNSPECIFIED: Unspecified phase type.\n - AUTOMATION_PHASE_TYPE_PRE: Pre-processing phase.\n - AUTOMATION_PHASE_TYPE_MAIN: Main processing phase.\n - AUTOMATION_PHASE_TYPE_POST: Post-processing phase."},"v1CollectionRef":{"type":"object","properties":{"collection_id":{"type":"string","description":"The Bishop collection id that this slug resolves to."},"stage":{"$ref":"#/components/schemas/v1CollectionStage"}},"description":"CollectionRef references a first-class collection by the id it resolves to."},"v1CollectionStage":{"type":"string","enum":["COLLECTION_STAGE_UNSPECIFIED","COLLECTION_STAGE_DRAFT","COLLECTION_STAGE_PUBLISHED"],"default":"COLLECTION_STAGE_UNSPECIFIED","description":"CollectionStage identifies which stage of a collection a request targets.\n\n - COLLECTION_STAGE_UNSPECIFIED: Stage not specified.\n - COLLECTION_STAGE_DRAFT: The draft stage.\n - COLLECTION_STAGE_PUBLISHED: The published stage."},"v1RunState":{"type":"object","properties":{"pending":{"$ref":"#/components/schemas/v1PendingRunState"},"executing":{"$ref":"#/components/schemas/v1ExecutingRunState"},"stopping":{"$ref":"#/components/schemas/v1StoppingRunState"},"stopped":{"$ref":"#/components/schemas/v1StoppedRunState"},"awaiting_guidance":{"$ref":"#/components/schemas/v1AwaitingGuidanceRunState"},"completed":{"$ref":"#/components/schemas/v1CompletedRunState"},"failed":{"$ref":"#/components/schemas/v1FailedRunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when the run transitioned to this state.","readOnly":true},"archived":{"$ref":"#/components/schemas/v1ArchivedRunState"},"awaiting_answer":{"$ref":"#/components/schemas/v1AwaitingAnswerRunState"}},"description":"RunState represents the overall lifecycle state of a run.\nTracks the run from initial submission through completion or failure."},"v1PendingRunState":{"type":"object","description":"Run has been submitted and is waiting to start execution.\nThe run is queued and will begin when resources become available."},"v1ExecutingRunState":{"type":"object","description":"Run is currently being executed.\nCode is actively running and making progress."},"v1StoppingRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run is in the process of being stopped.\nExecution is stopping gracefully and will transition to STOPPED state."},"v1StoppedRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run has been stopped and can be resumed later.\nExecution is temporarily stopped but can continue from current state."},"v1AwaitingGuidanceRunState":{"type":"object","properties":{"exception":{"type":"string","title":"ID of the exception (from guidance center)","readOnly":true},"description":{"type":"string","description":"Description of the exception that occured.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"},"rain_thread_id":{"type":"string","description":"The Rain thread ID for this exception on the Astral-on-Rain path. Each\nexception gets its own Rain thread so clients can subscribe to just this\nexception's events. Empty on the local path or when Rain is disabled.","readOnly":true}},"description":"Run is waiting for external guidance or user input.\nRequires manual intervention or external decision to proceed."},"commonV1Location":{"type":"object","properties":{"start_byte":{"type":"string","format":"int64","title":"Starting Byte of the span, It will be zero-based"},"end_byte":{"type":"string","format":"int64","title":"Ending Byte(exclusive) of the span, It will be zero-based"},"start_position":{"$ref":"#/components/schemas/v1Position"},"end_position":{"$ref":"#/components/schemas/v1Position"}},"description":"Location represents a generic span within some underlying content.\nIt specifies the starting byte offset and the ending byte offset (exclusive) of the span.\nThis can be used for pointing to regions in files, buffers, logs, messages,\nor any other byte-addressable resource."},"v1Position":{"type":"object","properties":{"line":{"type":"integer","format":"int32","description":"0-based line number."},"column":{"type":"integer","format":"int32","description":"0-based column offset (bytes from line start)."}},"description":"A position in a text document expressed as 0-based line and column."},"v1CompletedRunState":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The outputs of the run.","readOnly":true}},"description":"Run has completed successfully.\nAll code has been executed and results are available."},"v1FailedRunState":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the error that caused the run to fail.","readOnly":true},"description":{"type":"string","description":"The description of the error.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"}},"description":"Run has failed due to an error.\nExecution stopped due to an unrecoverable error condition."},"v1ArchivedRunState":{"type":"object","description":"Run has been archived by the user.\nThe run is preserved for historical reference but cannot be modified,\nresumed, or mutated in any way."},"v1AwaitingAnswerRunState":{"type":"object","properties":{"invocation_id":{"type":"string","description":"Identity of the ask() invocation the run is waiting on.","readOnly":true},"question_key":{"type":"string","description":"Author-supplied key identifying the recurring logical question.","readOnly":true},"prompt":{"type":"string","description":"The question shown to the person.","readOnly":true},"form":{"$ref":"#/components/schemas/v1FormSpec"},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Supporting values frozen with the question.","readOnly":true}},"description":"Run is intentionally waiting for a person to answer an ask() question.\nThis is planned waiting, not a failure or an exception: the run resumes once\nthe question is answered through the authoring experience or Workbench."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1AutomationStage":{"type":"string","enum":["AUTOMATION_STAGE_UNSPECIFIED","AUTOMATION_STAGE_DRAFT","AUTOMATION_STAGE_PUBLISHED"],"default":"AUTOMATION_STAGE_UNSPECIFIED","description":"AutomationStage represents the publication stage of an automation.\nThis enum is shared across services that manage or execute automations.\n\n - AUTOMATION_STAGE_UNSPECIFIED: Automation stage is not specified.\n - AUTOMATION_STAGE_DRAFT: Automation is in draft stage and can be modified.\n - AUTOMATION_STAGE_PUBLISHED: Automation is published and immutable, ready for execution."},"v1InvocationDetails":{"type":"object","properties":{"trigger_id":{"type":"string","description":"The ID of the trigger that initiated this run, if applicable."},"user_id":{"type":"string","description":"The ID of the user that initiated this run, if applicable."},"invocation_source":{"$ref":"#/components/schemas/v1InvocationSource"}},"description":"InvocationDetails contains additional information about the entity that initiated a run."},"v1InvocationSource":{"type":"string","enum":["INVOCATION_SOURCE_UNSPECIFIED","INVOCATION_SOURCE_MANUAL","INVOCATION_SOURCE_TRIGGER","INVOCATION_SOURCE_SCHEDULE","INVOCATION_SOURCE_PAT","INVOCATION_SOURCE_TEST"],"default":"INVOCATION_SOURCE_UNSPECIFIED","description":"InvocationSource identifies the entity responsible for creating a run.\n\n - INVOCATION_SOURCE_UNSPECIFIED: Unspecified invocation source.\n - INVOCATION_SOURCE_MANUAL: Run was manually initiated by a user.\n - INVOCATION_SOURCE_TRIGGER: Run was triggered by an event or trigger.\n - INVOCATION_SOURCE_SCHEDULE: Run was initiated by a schedule.\n - INVOCATION_SOURCE_PAT: Run was initiated via a Personal Access Token (PAT).\n - INVOCATION_SOURCE_TEST: Run was initiated by Quill agent for testing draft automations."},"v1RunContentCoverage":{"type":"object","properties":{"file_count":{"type":"integer","format":"int32","description":"The number of files found in the run.","readOnly":true},"indexed_file_count":{"type":"integer","format":"int32","description":"The number of files whose text is searchable.","readOnly":true},"partially_indexed_file_count":{"type":"integer","format":"int32","description":"The number of indexed files that are only partly searchable, because their\ntext was cut off at a size limit or some of their pages have no text layer.\nThese files are also counted in indexed_file_count, so this is never larger.","readOnly":true},"pending_file_count":{"type":"integer","format":"int32","description":"The number of files not indexed yet: waiting, being read, or due for a\nretry after a temporary error.","readOnly":true},"skipped_file_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1SkippedFileCount"},"description":"The files that will not be indexed, counted by reason. Holds one entry for\neach reason that applies to at least one file, in no particular order.","readOnly":true}},"description":"RunContentCoverage counts a run's files by whether the ListRuns search filter\nterm can match the text inside them.\n\nThe files counted are those in the run's inputs, outputs and trigger payload,\nthe files its steps used as recorded in the Run log, and text values offloaded\nto object storage. Text the steps produced is not a file and is not counted. A\nfile is counted once however many places it appears in, and in exactly one of\nindexed_file_count, pending_file_count and skipped_file_counts, so file_count\nis their sum. The counts cover the files found so far: a run that is still\nexecuting, or whose Run log has not been read yet, can gain files later."},"v1SkippedFileCount":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/v1ContentSkipReason"},"file_count":{"type":"integer","format":"int32","description":"The number of files skipped for this reason.","readOnly":true}},"description":"The number of a run's files that content search skipped for one reason."},"v1ContentSkipReason":{"type":"string","enum":["CONTENT_SKIP_REASON_UNSPECIFIED","CONTENT_SKIP_REASON_NO_TEXT_LAYER","CONTENT_SKIP_REASON_TOO_LARGE","CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT","CONTENT_SKIP_REASON_ENCRYPTED","CONTENT_SKIP_REASON_FAILED","CONTENT_SKIP_REASON_TOO_MANY_FILES","CONTENT_SKIP_REASON_INACCESSIBLE"],"default":"CONTENT_SKIP_REASON_UNSPECIFIED","description":"Why content search will not index one of a run's files.\nMore reasons may be added; treat a value you do not recognize as a file that\nis not searchable for an unstated reason.\n\n - CONTENT_SKIP_REASON_UNSPECIFIED: Unspecified reason. Not returned by the server.\n - CONTENT_SKIP_REASON_NO_TEXT_LAYER: The file has no text layer, such as an image or a scanned PDF. Content\nsearch does not run OCR.\n - CONTENT_SKIP_REASON_TOO_LARGE: The file is larger than content search reads. A file that is only cut off\nat a limit is indexed instead, and counted in\nRunContentCoverage.partially_indexed_file_count.\n - CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT: Content search cannot read the file's format, such as a legacy Word or\nPowerPoint document, an Outlook message, or an archive.\n - CONTENT_SKIP_REASON_ENCRYPTED: The file is password-protected.\n - CONTENT_SKIP_REASON_FAILED: Reading the file failed and will not be retried, for example because the\nfile is corrupt, or reading it kept crashing or timing out.\n - CONTENT_SKIP_REASON_TOO_MANY_FILES: The run has more files than content search indexes for a single run, and\nthis file is beyond that limit.\n - CONTENT_SKIP_REASON_INACCESSIBLE: The file cannot be read from this run: it no longer exists, or the run\nrefers to it somewhere content search does not follow, such as another\nworkspace."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}":{"get":{"summary":"Get Run","operationId":"GetRun","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Run"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string"}}],"tags":["Runs"]}}}}
```

## GET /api/v1/organizations/{organization\_id}/workspaces/{workspace\_id}/automations/{automation\_id}/runs

> List Runs

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1ListRunsResponse":{"type":"object","properties":{"runs":{"type":"array","items":{"$ref":"#/components/schemas/v1Run"},"description":"The list of runs matching the request criteria.\nMay be empty if no runs are found or if the page is beyond available results.","readOnly":true},"next_page_token":{"type":"string","description":"A token that can be sent as `page_token` to retrieve the next page.\nIf this field is omitted, there are no subsequent pages.","readOnly":true},"content_matches":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1RunContentMatch"},"description":"For each run on this page that matched the filter's search term inside the\ntext of its files, which files matched and where, so a client can show why\nthe run matched when none of its values contain the term, for example\n\"matched in invoice.pdf, page 3\".\nKey: run name (format: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}),\nthe name of one of the runs in runs.\n\nFilled only when the filter has a search term, and only terms of at least 3\ncharacters are matched against file text. A run that matched on its values\nalone has no entry, and there are none when the organization opted out of\ncontent search. Entries name files and locations, never the matched text.","readOnly":true}},"description":"Response message for ListRuns method.\nContains a paginated list of runs and pagination metadata."},"v1Run":{"type":"object","properties":{"name":{"type":"string","title":"The name of the run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"executable_steps":{"$ref":"#/components/schemas/v1ExecutableSteps"},"create_time":{"type":"string","format":"date-time","description":"The timestamp when this run was created.\nSet automatically when the run is first submitted to the system.","readOnly":true},"state":{"$ref":"#/components/schemas/v1RunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when this run was updated.\nSet automatically when the run is updated.","readOnly":true},"previous_run":{"type":"string","title":"The name of the previous run in the chain, if applicable.\nExecution details of the previous run may be used to avoid re-computation.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"stage_version":{"type":"string","description":"The version of the automation stage at the time this run was created."},"invocation_details":{"$ref":"#/components/schemas/v1InvocationDetails"},"user_inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The user inputs provided to the run during pre phase and will be available for the UI to display the user inputs."},"root_run":{"type":"string","title":"The first run in this run's replay lineage. A run created fresh is its own\nroot; a run created by ReplayRun shares its source run's root. Lets a whole\nreplay lineage be fetched in one query (ListRuns filtered by root_run), and\ntop-level runs be listed by filtering for an empty previous_run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}","readOnly":true},"disable_exception_handling":{"type":"boolean","description":"Whether to disable exception creation and handling when this run encounters guidance\nand enters the Awaiting Guidance state.\nApplies only to draft-stage runs. Published-stage runs always use standard Astral exception handling."},"enable_astral_on_rain":{"type":"boolean","description":"Whether exception handling should be performed by the Astral agent deployed\non the Rain agent framework."},"active_step_index":{"type":"integer","format":"int32","description":"The zero-based index of the step currently executing within executable_steps.\nAbsent when executable_steps is empty (single-step runs without a pre-phase).","readOnly":true},"archived_time":{"type":"string","format":"date-time","description":"The timestamp when this run was archived, if it has been archived.\nWhen set, the run cannot be mutated (pause, resume, skip, patch, retry).\nThe state field continues to reflect the real terminal execution state.","readOnly":true},"content_coverage":{"$ref":"#/components/schemas/v1RunContentCoverage"}},"description":"Run represents a single execution instance of code in the Jeeves platform.\nContains the executable code, metadata, and current execution state.","required":["stage","stage_version"]},"v1ExecutableSteps":{"type":"object","properties":{"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Input parameters for the execution, provided as name-value pairs.\nThese variables will be available to the code during execution."},"executables":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutableStep"},"description":"The source code to be executed, written in SPy (Simplified Python) language."}},"description":"ExecutableSteps represents a sequence of steps of execution of a run. Each step is\na separate computable unit with its own code, book connections and optional inputs.\nThe first step may optionally have an input provided to it when the run is invoked.\nThe output of each step becomes the input of the next step and the output of the\nlast step becomes the output of the run.","required":["executables"]},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1ExecutableStep":{"type":"object","properties":{"code":{"type":"string","description":"The source code to be executed, written in SPy (Simplified Python) language.\nThis is the main logic that will be interpreted and run by the execution engine."},"book_connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections required by this executable.\nMaps connection names to their specific ID and endpoints."},"phase_type":{"$ref":"#/components/schemas/v1AutomationPhaseType"},"collections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1CollectionRef"},"description":"Collections referenced by this step.\nMaps each collection slug to its reference."},"index":{"type":"integer","format":"int32","description":"Zero-based position of this step within executable_steps.","readOnly":true},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Business-tunable config for this step, keyed by config name and resolved to\nplain values. Read in SPy as kognitos.config.<name>."}},"description":"ExecutableStep represents a piece of code that can be executed in the Jeeves platform.\nContains the source code, input parameters, and external dependencies needed for execution.","required":["code","phase_type"]},"v1BookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"Unique identifier for this connection resource."},"endpoint":{"type":"string","description":"Endpoint for the connection."}},"description":"BookConnection is a resource representing a connection to a book instance.\nA connection has a unique identifier and an endpoint."},"v1AutomationPhaseType":{"type":"string","enum":["AUTOMATION_PHASE_TYPE_UNSPECIFIED","AUTOMATION_PHASE_TYPE_PRE","AUTOMATION_PHASE_TYPE_MAIN","AUTOMATION_PHASE_TYPE_POST"],"default":"AUTOMATION_PHASE_TYPE_UNSPECIFIED","description":"PhaseType defines the type of phase for an automation trigger.\n\n - AUTOMATION_PHASE_TYPE_UNSPECIFIED: Unspecified phase type.\n - AUTOMATION_PHASE_TYPE_PRE: Pre-processing phase.\n - AUTOMATION_PHASE_TYPE_MAIN: Main processing phase.\n - AUTOMATION_PHASE_TYPE_POST: Post-processing phase."},"v1CollectionRef":{"type":"object","properties":{"collection_id":{"type":"string","description":"The Bishop collection id that this slug resolves to."},"stage":{"$ref":"#/components/schemas/v1CollectionStage"}},"description":"CollectionRef references a first-class collection by the id it resolves to."},"v1CollectionStage":{"type":"string","enum":["COLLECTION_STAGE_UNSPECIFIED","COLLECTION_STAGE_DRAFT","COLLECTION_STAGE_PUBLISHED"],"default":"COLLECTION_STAGE_UNSPECIFIED","description":"CollectionStage identifies which stage of a collection a request targets.\n\n - COLLECTION_STAGE_UNSPECIFIED: Stage not specified.\n - COLLECTION_STAGE_DRAFT: The draft stage.\n - COLLECTION_STAGE_PUBLISHED: The published stage."},"v1RunState":{"type":"object","properties":{"pending":{"$ref":"#/components/schemas/v1PendingRunState"},"executing":{"$ref":"#/components/schemas/v1ExecutingRunState"},"stopping":{"$ref":"#/components/schemas/v1StoppingRunState"},"stopped":{"$ref":"#/components/schemas/v1StoppedRunState"},"awaiting_guidance":{"$ref":"#/components/schemas/v1AwaitingGuidanceRunState"},"completed":{"$ref":"#/components/schemas/v1CompletedRunState"},"failed":{"$ref":"#/components/schemas/v1FailedRunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when the run transitioned to this state.","readOnly":true},"archived":{"$ref":"#/components/schemas/v1ArchivedRunState"},"awaiting_answer":{"$ref":"#/components/schemas/v1AwaitingAnswerRunState"}},"description":"RunState represents the overall lifecycle state of a run.\nTracks the run from initial submission through completion or failure."},"v1PendingRunState":{"type":"object","description":"Run has been submitted and is waiting to start execution.\nThe run is queued and will begin when resources become available."},"v1ExecutingRunState":{"type":"object","description":"Run is currently being executed.\nCode is actively running and making progress."},"v1StoppingRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run is in the process of being stopped.\nExecution is stopping gracefully and will transition to STOPPED state."},"v1StoppedRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run has been stopped and can be resumed later.\nExecution is temporarily stopped but can continue from current state."},"v1AwaitingGuidanceRunState":{"type":"object","properties":{"exception":{"type":"string","title":"ID of the exception (from guidance center)","readOnly":true},"description":{"type":"string","description":"Description of the exception that occured.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"},"rain_thread_id":{"type":"string","description":"The Rain thread ID for this exception on the Astral-on-Rain path. Each\nexception gets its own Rain thread so clients can subscribe to just this\nexception's events. Empty on the local path or when Rain is disabled.","readOnly":true}},"description":"Run is waiting for external guidance or user input.\nRequires manual intervention or external decision to proceed."},"commonV1Location":{"type":"object","properties":{"start_byte":{"type":"string","format":"int64","title":"Starting Byte of the span, It will be zero-based"},"end_byte":{"type":"string","format":"int64","title":"Ending Byte(exclusive) of the span, It will be zero-based"},"start_position":{"$ref":"#/components/schemas/v1Position"},"end_position":{"$ref":"#/components/schemas/v1Position"}},"description":"Location represents a generic span within some underlying content.\nIt specifies the starting byte offset and the ending byte offset (exclusive) of the span.\nThis can be used for pointing to regions in files, buffers, logs, messages,\nor any other byte-addressable resource."},"v1Position":{"type":"object","properties":{"line":{"type":"integer","format":"int32","description":"0-based line number."},"column":{"type":"integer","format":"int32","description":"0-based column offset (bytes from line start)."}},"description":"A position in a text document expressed as 0-based line and column."},"v1CompletedRunState":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The outputs of the run.","readOnly":true}},"description":"Run has completed successfully.\nAll code has been executed and results are available."},"v1FailedRunState":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the error that caused the run to fail.","readOnly":true},"description":{"type":"string","description":"The description of the error.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"}},"description":"Run has failed due to an error.\nExecution stopped due to an unrecoverable error condition."},"v1ArchivedRunState":{"type":"object","description":"Run has been archived by the user.\nThe run is preserved for historical reference but cannot be modified,\nresumed, or mutated in any way."},"v1AwaitingAnswerRunState":{"type":"object","properties":{"invocation_id":{"type":"string","description":"Identity of the ask() invocation the run is waiting on.","readOnly":true},"question_key":{"type":"string","description":"Author-supplied key identifying the recurring logical question.","readOnly":true},"prompt":{"type":"string","description":"The question shown to the person.","readOnly":true},"form":{"$ref":"#/components/schemas/v1FormSpec"},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Supporting values frozen with the question.","readOnly":true}},"description":"Run is intentionally waiting for a person to answer an ask() question.\nThis is planned waiting, not a failure or an exception: the run resumes once\nthe question is answered through the authoring experience or Workbench."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1AutomationStage":{"type":"string","enum":["AUTOMATION_STAGE_UNSPECIFIED","AUTOMATION_STAGE_DRAFT","AUTOMATION_STAGE_PUBLISHED"],"default":"AUTOMATION_STAGE_UNSPECIFIED","description":"AutomationStage represents the publication stage of an automation.\nThis enum is shared across services that manage or execute automations.\n\n - AUTOMATION_STAGE_UNSPECIFIED: Automation stage is not specified.\n - AUTOMATION_STAGE_DRAFT: Automation is in draft stage and can be modified.\n - AUTOMATION_STAGE_PUBLISHED: Automation is published and immutable, ready for execution."},"v1InvocationDetails":{"type":"object","properties":{"trigger_id":{"type":"string","description":"The ID of the trigger that initiated this run, if applicable."},"user_id":{"type":"string","description":"The ID of the user that initiated this run, if applicable."},"invocation_source":{"$ref":"#/components/schemas/v1InvocationSource"}},"description":"InvocationDetails contains additional information about the entity that initiated a run."},"v1InvocationSource":{"type":"string","enum":["INVOCATION_SOURCE_UNSPECIFIED","INVOCATION_SOURCE_MANUAL","INVOCATION_SOURCE_TRIGGER","INVOCATION_SOURCE_SCHEDULE","INVOCATION_SOURCE_PAT","INVOCATION_SOURCE_TEST"],"default":"INVOCATION_SOURCE_UNSPECIFIED","description":"InvocationSource identifies the entity responsible for creating a run.\n\n - INVOCATION_SOURCE_UNSPECIFIED: Unspecified invocation source.\n - INVOCATION_SOURCE_MANUAL: Run was manually initiated by a user.\n - INVOCATION_SOURCE_TRIGGER: Run was triggered by an event or trigger.\n - INVOCATION_SOURCE_SCHEDULE: Run was initiated by a schedule.\n - INVOCATION_SOURCE_PAT: Run was initiated via a Personal Access Token (PAT).\n - INVOCATION_SOURCE_TEST: Run was initiated by Quill agent for testing draft automations."},"v1RunContentCoverage":{"type":"object","properties":{"file_count":{"type":"integer","format":"int32","description":"The number of files found in the run.","readOnly":true},"indexed_file_count":{"type":"integer","format":"int32","description":"The number of files whose text is searchable.","readOnly":true},"partially_indexed_file_count":{"type":"integer","format":"int32","description":"The number of indexed files that are only partly searchable, because their\ntext was cut off at a size limit or some of their pages have no text layer.\nThese files are also counted in indexed_file_count, so this is never larger.","readOnly":true},"pending_file_count":{"type":"integer","format":"int32","description":"The number of files not indexed yet: waiting, being read, or due for a\nretry after a temporary error.","readOnly":true},"skipped_file_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1SkippedFileCount"},"description":"The files that will not be indexed, counted by reason. Holds one entry for\neach reason that applies to at least one file, in no particular order.","readOnly":true}},"description":"RunContentCoverage counts a run's files by whether the ListRuns search filter\nterm can match the text inside them.\n\nThe files counted are those in the run's inputs, outputs and trigger payload,\nthe files its steps used as recorded in the Run log, and text values offloaded\nto object storage. Text the steps produced is not a file and is not counted. A\nfile is counted once however many places it appears in, and in exactly one of\nindexed_file_count, pending_file_count and skipped_file_counts, so file_count\nis their sum. The counts cover the files found so far: a run that is still\nexecuting, or whose Run log has not been read yet, can gain files later."},"v1SkippedFileCount":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/v1ContentSkipReason"},"file_count":{"type":"integer","format":"int32","description":"The number of files skipped for this reason.","readOnly":true}},"description":"The number of a run's files that content search skipped for one reason."},"v1ContentSkipReason":{"type":"string","enum":["CONTENT_SKIP_REASON_UNSPECIFIED","CONTENT_SKIP_REASON_NO_TEXT_LAYER","CONTENT_SKIP_REASON_TOO_LARGE","CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT","CONTENT_SKIP_REASON_ENCRYPTED","CONTENT_SKIP_REASON_FAILED","CONTENT_SKIP_REASON_TOO_MANY_FILES","CONTENT_SKIP_REASON_INACCESSIBLE"],"default":"CONTENT_SKIP_REASON_UNSPECIFIED","description":"Why content search will not index one of a run's files.\nMore reasons may be added; treat a value you do not recognize as a file that\nis not searchable for an unstated reason.\n\n - CONTENT_SKIP_REASON_UNSPECIFIED: Unspecified reason. Not returned by the server.\n - CONTENT_SKIP_REASON_NO_TEXT_LAYER: The file has no text layer, such as an image or a scanned PDF. Content\nsearch does not run OCR.\n - CONTENT_SKIP_REASON_TOO_LARGE: The file is larger than content search reads. A file that is only cut off\nat a limit is indexed instead, and counted in\nRunContentCoverage.partially_indexed_file_count.\n - CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT: Content search cannot read the file's format, such as a legacy Word or\nPowerPoint document, an Outlook message, or an archive.\n - CONTENT_SKIP_REASON_ENCRYPTED: The file is password-protected.\n - CONTENT_SKIP_REASON_FAILED: Reading the file failed and will not be retried, for example because the\nfile is corrupt, or reading it kept crashing or timing out.\n - CONTENT_SKIP_REASON_TOO_MANY_FILES: The run has more files than content search indexes for a single run, and\nthis file is beyond that limit.\n - CONTENT_SKIP_REASON_INACCESSIBLE: The file cannot be read from this run: it no longer exists, or the run\nrefers to it somewhere content search does not follow, such as another\nworkspace."},"v1RunContentMatch":{"type":"object","properties":{"file_matches":{"type":"array","items":{"$ref":"#/components/schemas/v1FileContentMatch"},"description":"The files whose text contains a search term. A file can have more than one\nentry, for example an input that a step also read. Holds at most a\nserver-chosen number of entries, and file_match_count says how many there are\nin all; the limit is an operational choice and may change, so do not treat it\nas part of the contract.","readOnly":true},"file_match_count":{"type":"integer","format":"int32","description":"The number of entries file_matches would hold without its limit, so a client\ncan show how many were left out.","readOnly":true}},"description":"Where a run matched the ListRuns search term inside the text of its files.\nNames files and locations only, never the matched text."},"v1FileContentMatch":{"type":"object","properties":{"display_name":{"type":"string","description":"The file's name, such as \"invoice.pdf\". Empty when there is no name: an\nunnamed file, an offloaded text value (field names it instead), or text a\nstep produced without reading a file.","readOnly":true},"source":{"$ref":"#/components/schemas/v1ContentMatchSource"},"field":{"type":"string","description":"For the CONTENT_MATCH_SOURCE_INPUT, _OUTPUT and _TRIGGER sources, the name of\nthe value the match is in, as it appears in the run's inputs, outputs or\ntrigger payload; for a file inside a list or dictionary, the name of the outer\nvalue. Empty for the other sources.","readOnly":true},"step_label":{"type":"string","description":"For the CONTENT_MATCH_SOURCE_STEP_FILE and _STEP_OUTPUT sources, a\nhuman-readable label for the step as the Run log shows it, such as\n\"Step 4: Extract the invoice fields\". Empty for the other sources.","readOnly":true},"locations":{"type":"array","items":{"$ref":"#/components/schemas/v1ContentLocation"},"description":"Where in the file the term was found, in document order. Holds at most a\nserver-chosen number of locations, so a term found on many pages lists only\nthe first of them. Empty when the format has no finer location, as with plain\ntext, CSV and Word documents, and for text a step produced.","readOnly":true}},"description":"One place in a run whose text contains the search term: a file, or text one of\nthe run's steps produced."},"v1ContentMatchSource":{"type":"string","enum":["CONTENT_MATCH_SOURCE_UNSPECIFIED","CONTENT_MATCH_SOURCE_INPUT","CONTENT_MATCH_SOURCE_OUTPUT","CONTENT_MATCH_SOURCE_TRIGGER","CONTENT_MATCH_SOURCE_STEP_FILE","CONTENT_MATCH_SOURCE_STEP_OUTPUT"],"default":"CONTENT_MATCH_SOURCE_UNSPECIFIED","description":"Where in a run a content match was found.\nMore sources may be added; treat a value you do not recognize as an unknown\nplace in the run.\n\n - CONTENT_MATCH_SOURCE_UNSPECIFIED: Unspecified source. Not returned by the server.\n - CONTENT_MATCH_SOURCE_INPUT: A file in the run's inputs (user_inputs).\n - CONTENT_MATCH_SOURCE_OUTPUT: A file in the run's outputs.\n - CONTENT_MATCH_SOURCE_TRIGGER: A file in the payload the run was started with, such as an attachment of the\nemail that triggered it, when the file is not also one of the run's inputs.\n - CONTENT_MATCH_SOURCE_STEP_FILE: A file one of the run's steps used, found through the Run log.\n - CONTENT_MATCH_SOURCE_STEP_OUTPUT: Text one of the run's steps produced, found through the Run log, such as the\nfields a document-processing book extracted. display_name names the file the\nstep read, if it read one."},"v1ContentLocation":{"type":"object","properties":{"page_number":{"type":"integer","format":"int32","description":"The 1-based page number, in a paginated document such as a PDF."},"sheet":{"type":"string","description":"The name of the sheet, in a spreadsheet."},"email_part":{"$ref":"#/components/schemas/v1EmailPart"},"email_attachment":{"type":"string","description":"The file name of an attachment, in an email file (.eml); the term was found\nin the attachment's text."}},"description":"A location inside a file where the search term was found."},"v1EmailPart":{"type":"string","enum":["EMAIL_PART_UNSPECIFIED","EMAIL_PART_SUBJECT","EMAIL_PART_HEADERS","EMAIL_PART_BODY"],"default":"EMAIL_PART_UNSPECIFIED","description":"A part of an email message.\n\n - EMAIL_PART_UNSPECIFIED: Unspecified email part. Not returned by the server.\n - EMAIL_PART_SUBJECT: The subject line.\n - EMAIL_PART_HEADERS: The headers other than the subject, such as the sender and recipients.\n - EMAIL_PART_BODY: The message body."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs":{"get":{"summary":"List Runs","operationId":"ListRuns","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1ListRunsResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page_size","description":"The maximum number of runs to return in a single response.\nThe service may return fewer than this value.\nIf unspecified or 0, at most 10 runs will be returned.\nThe maximum value is 1000; values above 1000 will be coerced to 1000.\nIf negative, an INVALID_ARGUMENT error will be returned.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"page_token","description":"A page token received from a previous `ListRuns` call.\nProvide this to retrieve the subsequent page of results.\nWhen paginating, all other parameters provided to `ListRuns` must match\nthe call that provided the page token.","in":"query","required":false,"schema":{"type":"string"}},{"name":"filter","description":"Filter expression for filtering runs.\nFollows the structured syntax defined in AIP-160.\n\nSupported fields and operators for filtering:\n- create_time: The timestamp when the run was created (google.protobuf.Timestamp).\n  Supports =, !=, <, >, <=, >=.\n- previous_run: The run that was replayed to produce this run (string).\n  Supports = and != with a run resource name or an empty string. Filter for\n  an empty value to return only top-level runs (those not produced by a replay).\n- root_run: The first run in this run's replay lineage (string).\n  Supports = and != with a run resource name. Filter by a run name to return\n  that run together with every replay derived from it.\n- runState: The current execution state of the run. Supports = and !=.\n  Valid values: Created, Pending, Executing, Stopped, NeedsWakeup,\n  WaitingForTimer, NeedsGuidance, WaitingForGuidance, WaitingForBook, Completed.\n- stage: The automation stage for the run. Supports = and !=.\n  Valid values: Draft, Published.\n- automation_id: The automation identifier for the run. Supports =.\n- stage_version: The automation stage version for the run. Supports = and !=.\n- invocation_source: The entity that initiated the run. Supports = and !=.\n  Valid values: Unspecified, Manual, Trigger, Schedule, Test, Pat, or the\n  corresponding InvocationSource enum names.\n- archived: Whether the run has been archived. Supports = with unquoted\n  boolean values true or false. If omitted, only non-archived runs are returned.\n- search: Free-text search. Supports only the : (has) operator, which matches a\n  case-insensitive substring. Unlike every other field this does not name a\n  column; the term is matched against, in one pass:\n    * every input name and value (runs created before user_inputs existed, and\n      multi-step runs other than a PRE -> MAIN handoff, have no stored inputs and\n      so cannot match on them),\n    * every output name and value of a completed run,\n    * the run id, stage version, invocation source and initiating user id,\n    * the display labels of invocation source and run state, so \"personal access\n      token\" matches a run stored as \"pat\",\n    * the text inside the run's files, when the term has at least 3 characters\n      (content search, below).\n  Not matched: numeric values, because a number persists as a mantissa plus a\n  flags bitfield and decoding it per row is too expensive for a keyword scan; and\n  values offloaded to object storage, whose content is not in the database,\n  except offloaded text, which content search reads. A file matches on its name\n  when stored inline, and on its resource path when offloaded. A term longer\n  than 256 characters is rejected.\n  Several search terms may be combined with AND; each must match somewhere.\n\n  Content search matches the term, case-insensitively, against text extracted\n  from the files in the run's inputs, outputs and trigger payload (every email\n  attachment included), from offloaded text values, and, through the Run log,\n  from the files the run's steps used and the text they produced, such as the\n  fields a document-processing book extracted. A run that matches this way has\n  an entry in ListRunsResponse.content_matches naming the file and where in it\n  the term was found, never the matched text. Content search has these limits:\n    * only Published runs are indexed, so a Draft run matches on its values only,\n    * an organization that opted out of content search gets values-only search,\n    * files are indexed in the background, so a file becomes searchable some\n      time after the run records it, typically within minutes,\n    * pages without a text layer, such as scans and images, are not searchable\n      because no OCR is run; Run.content_coverage counts each run's files that\n      are not searchable, and why.\n\nSupported logical operators:\n- AND may combine conditions across fields.\n- OR may combine conditions for the same field only.\n\nExamples:\n- Filter runs created after a specific date (start_date):\n  \"create_time >= \\\"2024-01-01T00:00:00Z\\\"\"\n- Only top-level runs (exclude replays):\n  \"previous_run = \\\"\\\"\"\n- A run and its full replay lineage:\n  \"root_run = \\\"organizations/1/workspaces/2/automations/3/runs/4\\\"\"\n- Filter runs created before a specific date (end_date):\n  \"create_time <= \\\"2024-12-31T23:59:59Z\\\"\"\n- Filter runs within a date range (start_date and end_date):\n  \"create_time >= \\\"2024-01-01T00:00:00Z\\\" AND create_time <= \\\"2024-12-31T23:59:59Z\\\"\"\n- Filter runs in specific states:\n  \"runState = \\\"Executing\\\" OR runState = \\\"Pending\\\"\"\n- Filter published runs from a specific stage version:\n  \"stage = \\\"Published\\\" AND stage_version = \\\"2\\\"\"\n- Filter by invocation source:\n  \"invocation_source = \\\"INVOCATION_SOURCE_MANUAL\\\"\"\n- Include only archived runs:\n  \"archived = true\"\n- Find the run that produced a particular output value:\n  \"search : \\\"ZIMUBKK80482811\\\"\"\n- Narrow a free-text search to a date range:\n  \"search : \\\"INV-90210\\\" AND create_time >= \\\"2024-01-01T00:00:00Z\\\"\"\n- Find the run whose attached PDF mentions a purchase order number:\n  \"search : \\\"PO-4471\\\"\"\n\nTimestamps must be in RFC-3339 format (e.g., \"2024-01-01T00:00:00Z\").\nIf an invalid filter expression is provided, the API will return INVALID_ARGUMENT.","in":"query","required":false,"schema":{"type":"string"}},{"name":"order_by","description":"Sort order for the returned runs. Follows AIP-132 ordering syntax.\n\nSupported fields for ordering:\n- create_time: The timestamp when the run was created\n\nSyntax: \"<field> <direction>\", where direction is \"asc\" or \"desc\".\n\nExamples:\n- \"create_time desc\"  (newest first)\n- \"create_time asc\"   (oldest first)\n\nIf unspecified, results are ordered by create_time descending (newest first),\npreserving existing behavior. An unsupported field or direction returns\nINVALID_ARGUMENT.","in":"query","required":false,"schema":{"type":"string"}}],"tags":["Runs"]}}}}
```

## Create Run

> Creates a new run with the specified executable code and inputs.\
> The run will be queued for execution and assigned a unique identifier.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1Run":{"type":"object","properties":{"name":{"type":"string","title":"The name of the run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"executable_steps":{"$ref":"#/components/schemas/v1ExecutableSteps"},"create_time":{"type":"string","format":"date-time","description":"The timestamp when this run was created.\nSet automatically when the run is first submitted to the system.","readOnly":true},"state":{"$ref":"#/components/schemas/v1RunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when this run was updated.\nSet automatically when the run is updated.","readOnly":true},"previous_run":{"type":"string","title":"The name of the previous run in the chain, if applicable.\nExecution details of the previous run may be used to avoid re-computation.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"stage_version":{"type":"string","description":"The version of the automation stage at the time this run was created."},"invocation_details":{"$ref":"#/components/schemas/v1InvocationDetails"},"user_inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The user inputs provided to the run during pre phase and will be available for the UI to display the user inputs."},"root_run":{"type":"string","title":"The first run in this run's replay lineage. A run created fresh is its own\nroot; a run created by ReplayRun shares its source run's root. Lets a whole\nreplay lineage be fetched in one query (ListRuns filtered by root_run), and\ntop-level runs be listed by filtering for an empty previous_run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}","readOnly":true},"disable_exception_handling":{"type":"boolean","description":"Whether to disable exception creation and handling when this run encounters guidance\nand enters the Awaiting Guidance state.\nApplies only to draft-stage runs. Published-stage runs always use standard Astral exception handling."},"enable_astral_on_rain":{"type":"boolean","description":"Whether exception handling should be performed by the Astral agent deployed\non the Rain agent framework."},"active_step_index":{"type":"integer","format":"int32","description":"The zero-based index of the step currently executing within executable_steps.\nAbsent when executable_steps is empty (single-step runs without a pre-phase).","readOnly":true},"archived_time":{"type":"string","format":"date-time","description":"The timestamp when this run was archived, if it has been archived.\nWhen set, the run cannot be mutated (pause, resume, skip, patch, retry).\nThe state field continues to reflect the real terminal execution state.","readOnly":true},"content_coverage":{"$ref":"#/components/schemas/v1RunContentCoverage"}},"description":"Run represents a single execution instance of code in the Jeeves platform.\nContains the executable code, metadata, and current execution state.","required":["stage","stage_version"]},"v1ExecutableSteps":{"type":"object","properties":{"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Input parameters for the execution, provided as name-value pairs.\nThese variables will be available to the code during execution."},"executables":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutableStep"},"description":"The source code to be executed, written in SPy (Simplified Python) language."}},"description":"ExecutableSteps represents a sequence of steps of execution of a run. Each step is\na separate computable unit with its own code, book connections and optional inputs.\nThe first step may optionally have an input provided to it when the run is invoked.\nThe output of each step becomes the input of the next step and the output of the\nlast step becomes the output of the run.","required":["executables"]},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1ExecutableStep":{"type":"object","properties":{"code":{"type":"string","description":"The source code to be executed, written in SPy (Simplified Python) language.\nThis is the main logic that will be interpreted and run by the execution engine."},"book_connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections required by this executable.\nMaps connection names to their specific ID and endpoints."},"phase_type":{"$ref":"#/components/schemas/v1AutomationPhaseType"},"collections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1CollectionRef"},"description":"Collections referenced by this step.\nMaps each collection slug to its reference."},"index":{"type":"integer","format":"int32","description":"Zero-based position of this step within executable_steps.","readOnly":true},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Business-tunable config for this step, keyed by config name and resolved to\nplain values. Read in SPy as kognitos.config.<name>."}},"description":"ExecutableStep represents a piece of code that can be executed in the Jeeves platform.\nContains the source code, input parameters, and external dependencies needed for execution.","required":["code","phase_type"]},"v1BookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"Unique identifier for this connection resource."},"endpoint":{"type":"string","description":"Endpoint for the connection."}},"description":"BookConnection is a resource representing a connection to a book instance.\nA connection has a unique identifier and an endpoint."},"v1AutomationPhaseType":{"type":"string","enum":["AUTOMATION_PHASE_TYPE_UNSPECIFIED","AUTOMATION_PHASE_TYPE_PRE","AUTOMATION_PHASE_TYPE_MAIN","AUTOMATION_PHASE_TYPE_POST"],"default":"AUTOMATION_PHASE_TYPE_UNSPECIFIED","description":"PhaseType defines the type of phase for an automation trigger.\n\n - AUTOMATION_PHASE_TYPE_UNSPECIFIED: Unspecified phase type.\n - AUTOMATION_PHASE_TYPE_PRE: Pre-processing phase.\n - AUTOMATION_PHASE_TYPE_MAIN: Main processing phase.\n - AUTOMATION_PHASE_TYPE_POST: Post-processing phase."},"v1CollectionRef":{"type":"object","properties":{"collection_id":{"type":"string","description":"The Bishop collection id that this slug resolves to."},"stage":{"$ref":"#/components/schemas/v1CollectionStage"}},"description":"CollectionRef references a first-class collection by the id it resolves to."},"v1CollectionStage":{"type":"string","enum":["COLLECTION_STAGE_UNSPECIFIED","COLLECTION_STAGE_DRAFT","COLLECTION_STAGE_PUBLISHED"],"default":"COLLECTION_STAGE_UNSPECIFIED","description":"CollectionStage identifies which stage of a collection a request targets.\n\n - COLLECTION_STAGE_UNSPECIFIED: Stage not specified.\n - COLLECTION_STAGE_DRAFT: The draft stage.\n - COLLECTION_STAGE_PUBLISHED: The published stage."},"v1RunState":{"type":"object","properties":{"pending":{"$ref":"#/components/schemas/v1PendingRunState"},"executing":{"$ref":"#/components/schemas/v1ExecutingRunState"},"stopping":{"$ref":"#/components/schemas/v1StoppingRunState"},"stopped":{"$ref":"#/components/schemas/v1StoppedRunState"},"awaiting_guidance":{"$ref":"#/components/schemas/v1AwaitingGuidanceRunState"},"completed":{"$ref":"#/components/schemas/v1CompletedRunState"},"failed":{"$ref":"#/components/schemas/v1FailedRunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when the run transitioned to this state.","readOnly":true},"archived":{"$ref":"#/components/schemas/v1ArchivedRunState"},"awaiting_answer":{"$ref":"#/components/schemas/v1AwaitingAnswerRunState"}},"description":"RunState represents the overall lifecycle state of a run.\nTracks the run from initial submission through completion or failure."},"v1PendingRunState":{"type":"object","description":"Run has been submitted and is waiting to start execution.\nThe run is queued and will begin when resources become available."},"v1ExecutingRunState":{"type":"object","description":"Run is currently being executed.\nCode is actively running and making progress."},"v1StoppingRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run is in the process of being stopped.\nExecution is stopping gracefully and will transition to STOPPED state."},"v1StoppedRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run has been stopped and can be resumed later.\nExecution is temporarily stopped but can continue from current state."},"v1AwaitingGuidanceRunState":{"type":"object","properties":{"exception":{"type":"string","title":"ID of the exception (from guidance center)","readOnly":true},"description":{"type":"string","description":"Description of the exception that occured.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"},"rain_thread_id":{"type":"string","description":"The Rain thread ID for this exception on the Astral-on-Rain path. Each\nexception gets its own Rain thread so clients can subscribe to just this\nexception's events. Empty on the local path or when Rain is disabled.","readOnly":true}},"description":"Run is waiting for external guidance or user input.\nRequires manual intervention or external decision to proceed."},"commonV1Location":{"type":"object","properties":{"start_byte":{"type":"string","format":"int64","title":"Starting Byte of the span, It will be zero-based"},"end_byte":{"type":"string","format":"int64","title":"Ending Byte(exclusive) of the span, It will be zero-based"},"start_position":{"$ref":"#/components/schemas/v1Position"},"end_position":{"$ref":"#/components/schemas/v1Position"}},"description":"Location represents a generic span within some underlying content.\nIt specifies the starting byte offset and the ending byte offset (exclusive) of the span.\nThis can be used for pointing to regions in files, buffers, logs, messages,\nor any other byte-addressable resource."},"v1Position":{"type":"object","properties":{"line":{"type":"integer","format":"int32","description":"0-based line number."},"column":{"type":"integer","format":"int32","description":"0-based column offset (bytes from line start)."}},"description":"A position in a text document expressed as 0-based line and column."},"v1CompletedRunState":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The outputs of the run.","readOnly":true}},"description":"Run has completed successfully.\nAll code has been executed and results are available."},"v1FailedRunState":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the error that caused the run to fail.","readOnly":true},"description":{"type":"string","description":"The description of the error.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"}},"description":"Run has failed due to an error.\nExecution stopped due to an unrecoverable error condition."},"v1ArchivedRunState":{"type":"object","description":"Run has been archived by the user.\nThe run is preserved for historical reference but cannot be modified,\nresumed, or mutated in any way."},"v1AwaitingAnswerRunState":{"type":"object","properties":{"invocation_id":{"type":"string","description":"Identity of the ask() invocation the run is waiting on.","readOnly":true},"question_key":{"type":"string","description":"Author-supplied key identifying the recurring logical question.","readOnly":true},"prompt":{"type":"string","description":"The question shown to the person.","readOnly":true},"form":{"$ref":"#/components/schemas/v1FormSpec"},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Supporting values frozen with the question.","readOnly":true}},"description":"Run is intentionally waiting for a person to answer an ask() question.\nThis is planned waiting, not a failure or an exception: the run resumes once\nthe question is answered through the authoring experience or Workbench."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1AutomationStage":{"type":"string","enum":["AUTOMATION_STAGE_UNSPECIFIED","AUTOMATION_STAGE_DRAFT","AUTOMATION_STAGE_PUBLISHED"],"default":"AUTOMATION_STAGE_UNSPECIFIED","description":"AutomationStage represents the publication stage of an automation.\nThis enum is shared across services that manage or execute automations.\n\n - AUTOMATION_STAGE_UNSPECIFIED: Automation stage is not specified.\n - AUTOMATION_STAGE_DRAFT: Automation is in draft stage and can be modified.\n - AUTOMATION_STAGE_PUBLISHED: Automation is published and immutable, ready for execution."},"v1InvocationDetails":{"type":"object","properties":{"trigger_id":{"type":"string","description":"The ID of the trigger that initiated this run, if applicable."},"user_id":{"type":"string","description":"The ID of the user that initiated this run, if applicable."},"invocation_source":{"$ref":"#/components/schemas/v1InvocationSource"}},"description":"InvocationDetails contains additional information about the entity that initiated a run."},"v1InvocationSource":{"type":"string","enum":["INVOCATION_SOURCE_UNSPECIFIED","INVOCATION_SOURCE_MANUAL","INVOCATION_SOURCE_TRIGGER","INVOCATION_SOURCE_SCHEDULE","INVOCATION_SOURCE_PAT","INVOCATION_SOURCE_TEST"],"default":"INVOCATION_SOURCE_UNSPECIFIED","description":"InvocationSource identifies the entity responsible for creating a run.\n\n - INVOCATION_SOURCE_UNSPECIFIED: Unspecified invocation source.\n - INVOCATION_SOURCE_MANUAL: Run was manually initiated by a user.\n - INVOCATION_SOURCE_TRIGGER: Run was triggered by an event or trigger.\n - INVOCATION_SOURCE_SCHEDULE: Run was initiated by a schedule.\n - INVOCATION_SOURCE_PAT: Run was initiated via a Personal Access Token (PAT).\n - INVOCATION_SOURCE_TEST: Run was initiated by Quill agent for testing draft automations."},"v1RunContentCoverage":{"type":"object","properties":{"file_count":{"type":"integer","format":"int32","description":"The number of files found in the run.","readOnly":true},"indexed_file_count":{"type":"integer","format":"int32","description":"The number of files whose text is searchable.","readOnly":true},"partially_indexed_file_count":{"type":"integer","format":"int32","description":"The number of indexed files that are only partly searchable, because their\ntext was cut off at a size limit or some of their pages have no text layer.\nThese files are also counted in indexed_file_count, so this is never larger.","readOnly":true},"pending_file_count":{"type":"integer","format":"int32","description":"The number of files not indexed yet: waiting, being read, or due for a\nretry after a temporary error.","readOnly":true},"skipped_file_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1SkippedFileCount"},"description":"The files that will not be indexed, counted by reason. Holds one entry for\neach reason that applies to at least one file, in no particular order.","readOnly":true}},"description":"RunContentCoverage counts a run's files by whether the ListRuns search filter\nterm can match the text inside them.\n\nThe files counted are those in the run's inputs, outputs and trigger payload,\nthe files its steps used as recorded in the Run log, and text values offloaded\nto object storage. Text the steps produced is not a file and is not counted. A\nfile is counted once however many places it appears in, and in exactly one of\nindexed_file_count, pending_file_count and skipped_file_counts, so file_count\nis their sum. The counts cover the files found so far: a run that is still\nexecuting, or whose Run log has not been read yet, can gain files later."},"v1SkippedFileCount":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/v1ContentSkipReason"},"file_count":{"type":"integer","format":"int32","description":"The number of files skipped for this reason.","readOnly":true}},"description":"The number of a run's files that content search skipped for one reason."},"v1ContentSkipReason":{"type":"string","enum":["CONTENT_SKIP_REASON_UNSPECIFIED","CONTENT_SKIP_REASON_NO_TEXT_LAYER","CONTENT_SKIP_REASON_TOO_LARGE","CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT","CONTENT_SKIP_REASON_ENCRYPTED","CONTENT_SKIP_REASON_FAILED","CONTENT_SKIP_REASON_TOO_MANY_FILES","CONTENT_SKIP_REASON_INACCESSIBLE"],"default":"CONTENT_SKIP_REASON_UNSPECIFIED","description":"Why content search will not index one of a run's files.\nMore reasons may be added; treat a value you do not recognize as a file that\nis not searchable for an unstated reason.\n\n - CONTENT_SKIP_REASON_UNSPECIFIED: Unspecified reason. Not returned by the server.\n - CONTENT_SKIP_REASON_NO_TEXT_LAYER: The file has no text layer, such as an image or a scanned PDF. Content\nsearch does not run OCR.\n - CONTENT_SKIP_REASON_TOO_LARGE: The file is larger than content search reads. A file that is only cut off\nat a limit is indexed instead, and counted in\nRunContentCoverage.partially_indexed_file_count.\n - CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT: Content search cannot read the file's format, such as a legacy Word or\nPowerPoint document, an Outlook message, or an archive.\n - CONTENT_SKIP_REASON_ENCRYPTED: The file is password-protected.\n - CONTENT_SKIP_REASON_FAILED: Reading the file failed and will not be retried, for example because the\nfile is corrupt, or reading it kept crashing or timing out.\n - CONTENT_SKIP_REASON_TOO_MANY_FILES: The run has more files than content search indexes for a single run, and\nthis file is beyond that limit.\n - CONTENT_SKIP_REASON_INACCESSIBLE: The file cannot be read from this run: it no longer exists, or the run\nrefers to it somewhere content search does not follow, such as another\nworkspace."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs":{"post":{"summary":"Create Run","description":"Creates a new run with the specified executable code and inputs.\nThe run will be queued for execution and assigned a unique identifier.","operationId":"CreateRun","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Run"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"request_id","description":"Client-supplied UUID4 idempotency token for CreateRun.\nWhen set, Jeeves returns the existing run for the same\n(org, workspace, automation, request_id) within the retention window\ninstead of creating a duplicate.","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Run"}}},"description":"The run to be created, including executable code, inputs, and dependencies.","required":true},"tags":["Runs"]}}}}
```

## POST /api/v1/organizations/{organization\_id}/workspaces/{workspace\_id}/automations/{automation\_id}/runs/{run\_id}:pause

> Pause Run

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1Run":{"type":"object","properties":{"name":{"type":"string","title":"The name of the run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"executable_steps":{"$ref":"#/components/schemas/v1ExecutableSteps"},"create_time":{"type":"string","format":"date-time","description":"The timestamp when this run was created.\nSet automatically when the run is first submitted to the system.","readOnly":true},"state":{"$ref":"#/components/schemas/v1RunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when this run was updated.\nSet automatically when the run is updated.","readOnly":true},"previous_run":{"type":"string","title":"The name of the previous run in the chain, if applicable.\nExecution details of the previous run may be used to avoid re-computation.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"stage_version":{"type":"string","description":"The version of the automation stage at the time this run was created."},"invocation_details":{"$ref":"#/components/schemas/v1InvocationDetails"},"user_inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The user inputs provided to the run during pre phase and will be available for the UI to display the user inputs."},"root_run":{"type":"string","title":"The first run in this run's replay lineage. A run created fresh is its own\nroot; a run created by ReplayRun shares its source run's root. Lets a whole\nreplay lineage be fetched in one query (ListRuns filtered by root_run), and\ntop-level runs be listed by filtering for an empty previous_run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}","readOnly":true},"disable_exception_handling":{"type":"boolean","description":"Whether to disable exception creation and handling when this run encounters guidance\nand enters the Awaiting Guidance state.\nApplies only to draft-stage runs. Published-stage runs always use standard Astral exception handling."},"enable_astral_on_rain":{"type":"boolean","description":"Whether exception handling should be performed by the Astral agent deployed\non the Rain agent framework."},"active_step_index":{"type":"integer","format":"int32","description":"The zero-based index of the step currently executing within executable_steps.\nAbsent when executable_steps is empty (single-step runs without a pre-phase).","readOnly":true},"archived_time":{"type":"string","format":"date-time","description":"The timestamp when this run was archived, if it has been archived.\nWhen set, the run cannot be mutated (pause, resume, skip, patch, retry).\nThe state field continues to reflect the real terminal execution state.","readOnly":true},"content_coverage":{"$ref":"#/components/schemas/v1RunContentCoverage"}},"description":"Run represents a single execution instance of code in the Jeeves platform.\nContains the executable code, metadata, and current execution state.","required":["stage","stage_version"]},"v1ExecutableSteps":{"type":"object","properties":{"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Input parameters for the execution, provided as name-value pairs.\nThese variables will be available to the code during execution."},"executables":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutableStep"},"description":"The source code to be executed, written in SPy (Simplified Python) language."}},"description":"ExecutableSteps represents a sequence of steps of execution of a run. Each step is\na separate computable unit with its own code, book connections and optional inputs.\nThe first step may optionally have an input provided to it when the run is invoked.\nThe output of each step becomes the input of the next step and the output of the\nlast step becomes the output of the run.","required":["executables"]},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1ExecutableStep":{"type":"object","properties":{"code":{"type":"string","description":"The source code to be executed, written in SPy (Simplified Python) language.\nThis is the main logic that will be interpreted and run by the execution engine."},"book_connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections required by this executable.\nMaps connection names to their specific ID and endpoints."},"phase_type":{"$ref":"#/components/schemas/v1AutomationPhaseType"},"collections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1CollectionRef"},"description":"Collections referenced by this step.\nMaps each collection slug to its reference."},"index":{"type":"integer","format":"int32","description":"Zero-based position of this step within executable_steps.","readOnly":true},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Business-tunable config for this step, keyed by config name and resolved to\nplain values. Read in SPy as kognitos.config.<name>."}},"description":"ExecutableStep represents a piece of code that can be executed in the Jeeves platform.\nContains the source code, input parameters, and external dependencies needed for execution.","required":["code","phase_type"]},"v1BookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"Unique identifier for this connection resource."},"endpoint":{"type":"string","description":"Endpoint for the connection."}},"description":"BookConnection is a resource representing a connection to a book instance.\nA connection has a unique identifier and an endpoint."},"v1AutomationPhaseType":{"type":"string","enum":["AUTOMATION_PHASE_TYPE_UNSPECIFIED","AUTOMATION_PHASE_TYPE_PRE","AUTOMATION_PHASE_TYPE_MAIN","AUTOMATION_PHASE_TYPE_POST"],"default":"AUTOMATION_PHASE_TYPE_UNSPECIFIED","description":"PhaseType defines the type of phase for an automation trigger.\n\n - AUTOMATION_PHASE_TYPE_UNSPECIFIED: Unspecified phase type.\n - AUTOMATION_PHASE_TYPE_PRE: Pre-processing phase.\n - AUTOMATION_PHASE_TYPE_MAIN: Main processing phase.\n - AUTOMATION_PHASE_TYPE_POST: Post-processing phase."},"v1CollectionRef":{"type":"object","properties":{"collection_id":{"type":"string","description":"The Bishop collection id that this slug resolves to."},"stage":{"$ref":"#/components/schemas/v1CollectionStage"}},"description":"CollectionRef references a first-class collection by the id it resolves to."},"v1CollectionStage":{"type":"string","enum":["COLLECTION_STAGE_UNSPECIFIED","COLLECTION_STAGE_DRAFT","COLLECTION_STAGE_PUBLISHED"],"default":"COLLECTION_STAGE_UNSPECIFIED","description":"CollectionStage identifies which stage of a collection a request targets.\n\n - COLLECTION_STAGE_UNSPECIFIED: Stage not specified.\n - COLLECTION_STAGE_DRAFT: The draft stage.\n - COLLECTION_STAGE_PUBLISHED: The published stage."},"v1RunState":{"type":"object","properties":{"pending":{"$ref":"#/components/schemas/v1PendingRunState"},"executing":{"$ref":"#/components/schemas/v1ExecutingRunState"},"stopping":{"$ref":"#/components/schemas/v1StoppingRunState"},"stopped":{"$ref":"#/components/schemas/v1StoppedRunState"},"awaiting_guidance":{"$ref":"#/components/schemas/v1AwaitingGuidanceRunState"},"completed":{"$ref":"#/components/schemas/v1CompletedRunState"},"failed":{"$ref":"#/components/schemas/v1FailedRunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when the run transitioned to this state.","readOnly":true},"archived":{"$ref":"#/components/schemas/v1ArchivedRunState"},"awaiting_answer":{"$ref":"#/components/schemas/v1AwaitingAnswerRunState"}},"description":"RunState represents the overall lifecycle state of a run.\nTracks the run from initial submission through completion or failure."},"v1PendingRunState":{"type":"object","description":"Run has been submitted and is waiting to start execution.\nThe run is queued and will begin when resources become available."},"v1ExecutingRunState":{"type":"object","description":"Run is currently being executed.\nCode is actively running and making progress."},"v1StoppingRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run is in the process of being stopped.\nExecution is stopping gracefully and will transition to STOPPED state."},"v1StoppedRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run has been stopped and can be resumed later.\nExecution is temporarily stopped but can continue from current state."},"v1AwaitingGuidanceRunState":{"type":"object","properties":{"exception":{"type":"string","title":"ID of the exception (from guidance center)","readOnly":true},"description":{"type":"string","description":"Description of the exception that occured.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"},"rain_thread_id":{"type":"string","description":"The Rain thread ID for this exception on the Astral-on-Rain path. Each\nexception gets its own Rain thread so clients can subscribe to just this\nexception's events. Empty on the local path or when Rain is disabled.","readOnly":true}},"description":"Run is waiting for external guidance or user input.\nRequires manual intervention or external decision to proceed."},"commonV1Location":{"type":"object","properties":{"start_byte":{"type":"string","format":"int64","title":"Starting Byte of the span, It will be zero-based"},"end_byte":{"type":"string","format":"int64","title":"Ending Byte(exclusive) of the span, It will be zero-based"},"start_position":{"$ref":"#/components/schemas/v1Position"},"end_position":{"$ref":"#/components/schemas/v1Position"}},"description":"Location represents a generic span within some underlying content.\nIt specifies the starting byte offset and the ending byte offset (exclusive) of the span.\nThis can be used for pointing to regions in files, buffers, logs, messages,\nor any other byte-addressable resource."},"v1Position":{"type":"object","properties":{"line":{"type":"integer","format":"int32","description":"0-based line number."},"column":{"type":"integer","format":"int32","description":"0-based column offset (bytes from line start)."}},"description":"A position in a text document expressed as 0-based line and column."},"v1CompletedRunState":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The outputs of the run.","readOnly":true}},"description":"Run has completed successfully.\nAll code has been executed and results are available."},"v1FailedRunState":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the error that caused the run to fail.","readOnly":true},"description":{"type":"string","description":"The description of the error.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"}},"description":"Run has failed due to an error.\nExecution stopped due to an unrecoverable error condition."},"v1ArchivedRunState":{"type":"object","description":"Run has been archived by the user.\nThe run is preserved for historical reference but cannot be modified,\nresumed, or mutated in any way."},"v1AwaitingAnswerRunState":{"type":"object","properties":{"invocation_id":{"type":"string","description":"Identity of the ask() invocation the run is waiting on.","readOnly":true},"question_key":{"type":"string","description":"Author-supplied key identifying the recurring logical question.","readOnly":true},"prompt":{"type":"string","description":"The question shown to the person.","readOnly":true},"form":{"$ref":"#/components/schemas/v1FormSpec"},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Supporting values frozen with the question.","readOnly":true}},"description":"Run is intentionally waiting for a person to answer an ask() question.\nThis is planned waiting, not a failure or an exception: the run resumes once\nthe question is answered through the authoring experience or Workbench."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1AutomationStage":{"type":"string","enum":["AUTOMATION_STAGE_UNSPECIFIED","AUTOMATION_STAGE_DRAFT","AUTOMATION_STAGE_PUBLISHED"],"default":"AUTOMATION_STAGE_UNSPECIFIED","description":"AutomationStage represents the publication stage of an automation.\nThis enum is shared across services that manage or execute automations.\n\n - AUTOMATION_STAGE_UNSPECIFIED: Automation stage is not specified.\n - AUTOMATION_STAGE_DRAFT: Automation is in draft stage and can be modified.\n - AUTOMATION_STAGE_PUBLISHED: Automation is published and immutable, ready for execution."},"v1InvocationDetails":{"type":"object","properties":{"trigger_id":{"type":"string","description":"The ID of the trigger that initiated this run, if applicable."},"user_id":{"type":"string","description":"The ID of the user that initiated this run, if applicable."},"invocation_source":{"$ref":"#/components/schemas/v1InvocationSource"}},"description":"InvocationDetails contains additional information about the entity that initiated a run."},"v1InvocationSource":{"type":"string","enum":["INVOCATION_SOURCE_UNSPECIFIED","INVOCATION_SOURCE_MANUAL","INVOCATION_SOURCE_TRIGGER","INVOCATION_SOURCE_SCHEDULE","INVOCATION_SOURCE_PAT","INVOCATION_SOURCE_TEST"],"default":"INVOCATION_SOURCE_UNSPECIFIED","description":"InvocationSource identifies the entity responsible for creating a run.\n\n - INVOCATION_SOURCE_UNSPECIFIED: Unspecified invocation source.\n - INVOCATION_SOURCE_MANUAL: Run was manually initiated by a user.\n - INVOCATION_SOURCE_TRIGGER: Run was triggered by an event or trigger.\n - INVOCATION_SOURCE_SCHEDULE: Run was initiated by a schedule.\n - INVOCATION_SOURCE_PAT: Run was initiated via a Personal Access Token (PAT).\n - INVOCATION_SOURCE_TEST: Run was initiated by Quill agent for testing draft automations."},"v1RunContentCoverage":{"type":"object","properties":{"file_count":{"type":"integer","format":"int32","description":"The number of files found in the run.","readOnly":true},"indexed_file_count":{"type":"integer","format":"int32","description":"The number of files whose text is searchable.","readOnly":true},"partially_indexed_file_count":{"type":"integer","format":"int32","description":"The number of indexed files that are only partly searchable, because their\ntext was cut off at a size limit or some of their pages have no text layer.\nThese files are also counted in indexed_file_count, so this is never larger.","readOnly":true},"pending_file_count":{"type":"integer","format":"int32","description":"The number of files not indexed yet: waiting, being read, or due for a\nretry after a temporary error.","readOnly":true},"skipped_file_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1SkippedFileCount"},"description":"The files that will not be indexed, counted by reason. Holds one entry for\neach reason that applies to at least one file, in no particular order.","readOnly":true}},"description":"RunContentCoverage counts a run's files by whether the ListRuns search filter\nterm can match the text inside them.\n\nThe files counted are those in the run's inputs, outputs and trigger payload,\nthe files its steps used as recorded in the Run log, and text values offloaded\nto object storage. Text the steps produced is not a file and is not counted. A\nfile is counted once however many places it appears in, and in exactly one of\nindexed_file_count, pending_file_count and skipped_file_counts, so file_count\nis their sum. The counts cover the files found so far: a run that is still\nexecuting, or whose Run log has not been read yet, can gain files later."},"v1SkippedFileCount":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/v1ContentSkipReason"},"file_count":{"type":"integer","format":"int32","description":"The number of files skipped for this reason.","readOnly":true}},"description":"The number of a run's files that content search skipped for one reason."},"v1ContentSkipReason":{"type":"string","enum":["CONTENT_SKIP_REASON_UNSPECIFIED","CONTENT_SKIP_REASON_NO_TEXT_LAYER","CONTENT_SKIP_REASON_TOO_LARGE","CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT","CONTENT_SKIP_REASON_ENCRYPTED","CONTENT_SKIP_REASON_FAILED","CONTENT_SKIP_REASON_TOO_MANY_FILES","CONTENT_SKIP_REASON_INACCESSIBLE"],"default":"CONTENT_SKIP_REASON_UNSPECIFIED","description":"Why content search will not index one of a run's files.\nMore reasons may be added; treat a value you do not recognize as a file that\nis not searchable for an unstated reason.\n\n - CONTENT_SKIP_REASON_UNSPECIFIED: Unspecified reason. Not returned by the server.\n - CONTENT_SKIP_REASON_NO_TEXT_LAYER: The file has no text layer, such as an image or a scanned PDF. Content\nsearch does not run OCR.\n - CONTENT_SKIP_REASON_TOO_LARGE: The file is larger than content search reads. A file that is only cut off\nat a limit is indexed instead, and counted in\nRunContentCoverage.partially_indexed_file_count.\n - CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT: Content search cannot read the file's format, such as a legacy Word or\nPowerPoint document, an Outlook message, or an archive.\n - CONTENT_SKIP_REASON_ENCRYPTED: The file is password-protected.\n - CONTENT_SKIP_REASON_FAILED: Reading the file failed and will not be retried, for example because the\nfile is corrupt, or reading it kept crashing or timing out.\n - CONTENT_SKIP_REASON_TOO_MANY_FILES: The run has more files than content search indexes for a single run, and\nthis file is beyond that limit.\n - CONTENT_SKIP_REASON_INACCESSIBLE: The file cannot be read from this run: it no longer exists, or the run\nrefers to it somewhere content search does not follow, such as another\nworkspace."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"PauseRunBody":{"type":"object","properties":{"reason":{"type":"string","description":"The reason for pausing the run."}},"description":"Request message for PauseRun method.\nSpecifies which run to pause by its unique identifier.","required":["reason"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}:pause":{"post":{"summary":"Pause Run","operationId":"PauseRun","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Run"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PauseRunBody"}}},"required":true},"tags":["Runs"]}}}}
```

## POST /api/v1/organizations/{organization\_id}/workspaces/{workspace\_id}/automations/{automation\_id}/runs/{run\_id}:continue

> Continue Run

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1Run":{"type":"object","properties":{"name":{"type":"string","title":"The name of the run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"executable_steps":{"$ref":"#/components/schemas/v1ExecutableSteps"},"create_time":{"type":"string","format":"date-time","description":"The timestamp when this run was created.\nSet automatically when the run is first submitted to the system.","readOnly":true},"state":{"$ref":"#/components/schemas/v1RunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when this run was updated.\nSet automatically when the run is updated.","readOnly":true},"previous_run":{"type":"string","title":"The name of the previous run in the chain, if applicable.\nExecution details of the previous run may be used to avoid re-computation.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"stage_version":{"type":"string","description":"The version of the automation stage at the time this run was created."},"invocation_details":{"$ref":"#/components/schemas/v1InvocationDetails"},"user_inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The user inputs provided to the run during pre phase and will be available for the UI to display the user inputs."},"root_run":{"type":"string","title":"The first run in this run's replay lineage. A run created fresh is its own\nroot; a run created by ReplayRun shares its source run's root. Lets a whole\nreplay lineage be fetched in one query (ListRuns filtered by root_run), and\ntop-level runs be listed by filtering for an empty previous_run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}","readOnly":true},"disable_exception_handling":{"type":"boolean","description":"Whether to disable exception creation and handling when this run encounters guidance\nand enters the Awaiting Guidance state.\nApplies only to draft-stage runs. Published-stage runs always use standard Astral exception handling."},"enable_astral_on_rain":{"type":"boolean","description":"Whether exception handling should be performed by the Astral agent deployed\non the Rain agent framework."},"active_step_index":{"type":"integer","format":"int32","description":"The zero-based index of the step currently executing within executable_steps.\nAbsent when executable_steps is empty (single-step runs without a pre-phase).","readOnly":true},"archived_time":{"type":"string","format":"date-time","description":"The timestamp when this run was archived, if it has been archived.\nWhen set, the run cannot be mutated (pause, resume, skip, patch, retry).\nThe state field continues to reflect the real terminal execution state.","readOnly":true},"content_coverage":{"$ref":"#/components/schemas/v1RunContentCoverage"}},"description":"Run represents a single execution instance of code in the Jeeves platform.\nContains the executable code, metadata, and current execution state.","required":["stage","stage_version"]},"v1ExecutableSteps":{"type":"object","properties":{"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Input parameters for the execution, provided as name-value pairs.\nThese variables will be available to the code during execution."},"executables":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutableStep"},"description":"The source code to be executed, written in SPy (Simplified Python) language."}},"description":"ExecutableSteps represents a sequence of steps of execution of a run. Each step is\na separate computable unit with its own code, book connections and optional inputs.\nThe first step may optionally have an input provided to it when the run is invoked.\nThe output of each step becomes the input of the next step and the output of the\nlast step becomes the output of the run.","required":["executables"]},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1ExecutableStep":{"type":"object","properties":{"code":{"type":"string","description":"The source code to be executed, written in SPy (Simplified Python) language.\nThis is the main logic that will be interpreted and run by the execution engine."},"book_connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections required by this executable.\nMaps connection names to their specific ID and endpoints."},"phase_type":{"$ref":"#/components/schemas/v1AutomationPhaseType"},"collections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1CollectionRef"},"description":"Collections referenced by this step.\nMaps each collection slug to its reference."},"index":{"type":"integer","format":"int32","description":"Zero-based position of this step within executable_steps.","readOnly":true},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Business-tunable config for this step, keyed by config name and resolved to\nplain values. Read in SPy as kognitos.config.<name>."}},"description":"ExecutableStep represents a piece of code that can be executed in the Jeeves platform.\nContains the source code, input parameters, and external dependencies needed for execution.","required":["code","phase_type"]},"v1BookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"Unique identifier for this connection resource."},"endpoint":{"type":"string","description":"Endpoint for the connection."}},"description":"BookConnection is a resource representing a connection to a book instance.\nA connection has a unique identifier and an endpoint."},"v1AutomationPhaseType":{"type":"string","enum":["AUTOMATION_PHASE_TYPE_UNSPECIFIED","AUTOMATION_PHASE_TYPE_PRE","AUTOMATION_PHASE_TYPE_MAIN","AUTOMATION_PHASE_TYPE_POST"],"default":"AUTOMATION_PHASE_TYPE_UNSPECIFIED","description":"PhaseType defines the type of phase for an automation trigger.\n\n - AUTOMATION_PHASE_TYPE_UNSPECIFIED: Unspecified phase type.\n - AUTOMATION_PHASE_TYPE_PRE: Pre-processing phase.\n - AUTOMATION_PHASE_TYPE_MAIN: Main processing phase.\n - AUTOMATION_PHASE_TYPE_POST: Post-processing phase."},"v1CollectionRef":{"type":"object","properties":{"collection_id":{"type":"string","description":"The Bishop collection id that this slug resolves to."},"stage":{"$ref":"#/components/schemas/v1CollectionStage"}},"description":"CollectionRef references a first-class collection by the id it resolves to."},"v1CollectionStage":{"type":"string","enum":["COLLECTION_STAGE_UNSPECIFIED","COLLECTION_STAGE_DRAFT","COLLECTION_STAGE_PUBLISHED"],"default":"COLLECTION_STAGE_UNSPECIFIED","description":"CollectionStage identifies which stage of a collection a request targets.\n\n - COLLECTION_STAGE_UNSPECIFIED: Stage not specified.\n - COLLECTION_STAGE_DRAFT: The draft stage.\n - COLLECTION_STAGE_PUBLISHED: The published stage."},"v1RunState":{"type":"object","properties":{"pending":{"$ref":"#/components/schemas/v1PendingRunState"},"executing":{"$ref":"#/components/schemas/v1ExecutingRunState"},"stopping":{"$ref":"#/components/schemas/v1StoppingRunState"},"stopped":{"$ref":"#/components/schemas/v1StoppedRunState"},"awaiting_guidance":{"$ref":"#/components/schemas/v1AwaitingGuidanceRunState"},"completed":{"$ref":"#/components/schemas/v1CompletedRunState"},"failed":{"$ref":"#/components/schemas/v1FailedRunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when the run transitioned to this state.","readOnly":true},"archived":{"$ref":"#/components/schemas/v1ArchivedRunState"},"awaiting_answer":{"$ref":"#/components/schemas/v1AwaitingAnswerRunState"}},"description":"RunState represents the overall lifecycle state of a run.\nTracks the run from initial submission through completion or failure."},"v1PendingRunState":{"type":"object","description":"Run has been submitted and is waiting to start execution.\nThe run is queued and will begin when resources become available."},"v1ExecutingRunState":{"type":"object","description":"Run is currently being executed.\nCode is actively running and making progress."},"v1StoppingRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run is in the process of being stopped.\nExecution is stopping gracefully and will transition to STOPPED state."},"v1StoppedRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run has been stopped and can be resumed later.\nExecution is temporarily stopped but can continue from current state."},"v1AwaitingGuidanceRunState":{"type":"object","properties":{"exception":{"type":"string","title":"ID of the exception (from guidance center)","readOnly":true},"description":{"type":"string","description":"Description of the exception that occured.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"},"rain_thread_id":{"type":"string","description":"The Rain thread ID for this exception on the Astral-on-Rain path. Each\nexception gets its own Rain thread so clients can subscribe to just this\nexception's events. Empty on the local path or when Rain is disabled.","readOnly":true}},"description":"Run is waiting for external guidance or user input.\nRequires manual intervention or external decision to proceed."},"commonV1Location":{"type":"object","properties":{"start_byte":{"type":"string","format":"int64","title":"Starting Byte of the span, It will be zero-based"},"end_byte":{"type":"string","format":"int64","title":"Ending Byte(exclusive) of the span, It will be zero-based"},"start_position":{"$ref":"#/components/schemas/v1Position"},"end_position":{"$ref":"#/components/schemas/v1Position"}},"description":"Location represents a generic span within some underlying content.\nIt specifies the starting byte offset and the ending byte offset (exclusive) of the span.\nThis can be used for pointing to regions in files, buffers, logs, messages,\nor any other byte-addressable resource."},"v1Position":{"type":"object","properties":{"line":{"type":"integer","format":"int32","description":"0-based line number."},"column":{"type":"integer","format":"int32","description":"0-based column offset (bytes from line start)."}},"description":"A position in a text document expressed as 0-based line and column."},"v1CompletedRunState":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The outputs of the run.","readOnly":true}},"description":"Run has completed successfully.\nAll code has been executed and results are available."},"v1FailedRunState":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the error that caused the run to fail.","readOnly":true},"description":{"type":"string","description":"The description of the error.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"}},"description":"Run has failed due to an error.\nExecution stopped due to an unrecoverable error condition."},"v1ArchivedRunState":{"type":"object","description":"Run has been archived by the user.\nThe run is preserved for historical reference but cannot be modified,\nresumed, or mutated in any way."},"v1AwaitingAnswerRunState":{"type":"object","properties":{"invocation_id":{"type":"string","description":"Identity of the ask() invocation the run is waiting on.","readOnly":true},"question_key":{"type":"string","description":"Author-supplied key identifying the recurring logical question.","readOnly":true},"prompt":{"type":"string","description":"The question shown to the person.","readOnly":true},"form":{"$ref":"#/components/schemas/v1FormSpec"},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Supporting values frozen with the question.","readOnly":true}},"description":"Run is intentionally waiting for a person to answer an ask() question.\nThis is planned waiting, not a failure or an exception: the run resumes once\nthe question is answered through the authoring experience or Workbench."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1AutomationStage":{"type":"string","enum":["AUTOMATION_STAGE_UNSPECIFIED","AUTOMATION_STAGE_DRAFT","AUTOMATION_STAGE_PUBLISHED"],"default":"AUTOMATION_STAGE_UNSPECIFIED","description":"AutomationStage represents the publication stage of an automation.\nThis enum is shared across services that manage or execute automations.\n\n - AUTOMATION_STAGE_UNSPECIFIED: Automation stage is not specified.\n - AUTOMATION_STAGE_DRAFT: Automation is in draft stage and can be modified.\n - AUTOMATION_STAGE_PUBLISHED: Automation is published and immutable, ready for execution."},"v1InvocationDetails":{"type":"object","properties":{"trigger_id":{"type":"string","description":"The ID of the trigger that initiated this run, if applicable."},"user_id":{"type":"string","description":"The ID of the user that initiated this run, if applicable."},"invocation_source":{"$ref":"#/components/schemas/v1InvocationSource"}},"description":"InvocationDetails contains additional information about the entity that initiated a run."},"v1InvocationSource":{"type":"string","enum":["INVOCATION_SOURCE_UNSPECIFIED","INVOCATION_SOURCE_MANUAL","INVOCATION_SOURCE_TRIGGER","INVOCATION_SOURCE_SCHEDULE","INVOCATION_SOURCE_PAT","INVOCATION_SOURCE_TEST"],"default":"INVOCATION_SOURCE_UNSPECIFIED","description":"InvocationSource identifies the entity responsible for creating a run.\n\n - INVOCATION_SOURCE_UNSPECIFIED: Unspecified invocation source.\n - INVOCATION_SOURCE_MANUAL: Run was manually initiated by a user.\n - INVOCATION_SOURCE_TRIGGER: Run was triggered by an event or trigger.\n - INVOCATION_SOURCE_SCHEDULE: Run was initiated by a schedule.\n - INVOCATION_SOURCE_PAT: Run was initiated via a Personal Access Token (PAT).\n - INVOCATION_SOURCE_TEST: Run was initiated by Quill agent for testing draft automations."},"v1RunContentCoverage":{"type":"object","properties":{"file_count":{"type":"integer","format":"int32","description":"The number of files found in the run.","readOnly":true},"indexed_file_count":{"type":"integer","format":"int32","description":"The number of files whose text is searchable.","readOnly":true},"partially_indexed_file_count":{"type":"integer","format":"int32","description":"The number of indexed files that are only partly searchable, because their\ntext was cut off at a size limit or some of their pages have no text layer.\nThese files are also counted in indexed_file_count, so this is never larger.","readOnly":true},"pending_file_count":{"type":"integer","format":"int32","description":"The number of files not indexed yet: waiting, being read, or due for a\nretry after a temporary error.","readOnly":true},"skipped_file_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1SkippedFileCount"},"description":"The files that will not be indexed, counted by reason. Holds one entry for\neach reason that applies to at least one file, in no particular order.","readOnly":true}},"description":"RunContentCoverage counts a run's files by whether the ListRuns search filter\nterm can match the text inside them.\n\nThe files counted are those in the run's inputs, outputs and trigger payload,\nthe files its steps used as recorded in the Run log, and text values offloaded\nto object storage. Text the steps produced is not a file and is not counted. A\nfile is counted once however many places it appears in, and in exactly one of\nindexed_file_count, pending_file_count and skipped_file_counts, so file_count\nis their sum. The counts cover the files found so far: a run that is still\nexecuting, or whose Run log has not been read yet, can gain files later."},"v1SkippedFileCount":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/v1ContentSkipReason"},"file_count":{"type":"integer","format":"int32","description":"The number of files skipped for this reason.","readOnly":true}},"description":"The number of a run's files that content search skipped for one reason."},"v1ContentSkipReason":{"type":"string","enum":["CONTENT_SKIP_REASON_UNSPECIFIED","CONTENT_SKIP_REASON_NO_TEXT_LAYER","CONTENT_SKIP_REASON_TOO_LARGE","CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT","CONTENT_SKIP_REASON_ENCRYPTED","CONTENT_SKIP_REASON_FAILED","CONTENT_SKIP_REASON_TOO_MANY_FILES","CONTENT_SKIP_REASON_INACCESSIBLE"],"default":"CONTENT_SKIP_REASON_UNSPECIFIED","description":"Why content search will not index one of a run's files.\nMore reasons may be added; treat a value you do not recognize as a file that\nis not searchable for an unstated reason.\n\n - CONTENT_SKIP_REASON_UNSPECIFIED: Unspecified reason. Not returned by the server.\n - CONTENT_SKIP_REASON_NO_TEXT_LAYER: The file has no text layer, such as an image or a scanned PDF. Content\nsearch does not run OCR.\n - CONTENT_SKIP_REASON_TOO_LARGE: The file is larger than content search reads. A file that is only cut off\nat a limit is indexed instead, and counted in\nRunContentCoverage.partially_indexed_file_count.\n - CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT: Content search cannot read the file's format, such as a legacy Word or\nPowerPoint document, an Outlook message, or an archive.\n - CONTENT_SKIP_REASON_ENCRYPTED: The file is password-protected.\n - CONTENT_SKIP_REASON_FAILED: Reading the file failed and will not be retried, for example because the\nfile is corrupt, or reading it kept crashing or timing out.\n - CONTENT_SKIP_REASON_TOO_MANY_FILES: The run has more files than content search indexes for a single run, and\nthis file is beyond that limit.\n - CONTENT_SKIP_REASON_INACCESSIBLE: The file cannot be read from this run: it no longer exists, or the run\nrefers to it somewhere content search does not follow, such as another\nworkspace."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"ContinueRunBody":{"type":"object","description":"Request message for ContinueRun method.\nSpecifies which run to resume by its unique identifier."}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}:continue":{"post":{"summary":"Continue Run","operationId":"ContinueRun","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Run"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContinueRunBody"}}},"required":true},"tags":["Runs"]}}}}
```

## GET /api/v1/organizations/{organization\_id}/workspaces/{workspace\_id}:automationRunAggregates

> Query Automation Run Aggregates

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1QueryAutomationRunAggregatesResponse":{"type":"object","properties":{"automation_run_aggregates":{"type":"array","items":{"$ref":"#/components/schemas/v1AutomationRunAggregateEntry"},"description":"List of automation run statistics entries.","readOnly":true}},"description":"Response message for QueryAutomationRunAggregates method.\nContains statistics for each automation in the workspace."},"v1AutomationRunAggregateEntry":{"type":"object","properties":{"automation_id":{"type":"string","title":"The automation ID for this entry.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}","readOnly":true},"stats":{"$ref":"#/components/schemas/v1AutomationRunAggregate"}},"description":"Entry for automation run statistics.\nContains the automation ID and its associated run counts."},"v1AutomationRunAggregate":{"type":"object","properties":{"total_runs":{"type":"string","format":"int64","description":"The total number of runs for this automation.","readOnly":true},"completed_runs":{"type":"string","format":"int64","description":"The number of completed runs for this automation.","readOnly":true}},"description":"Stats for a single automation.\nContains run counts and other metrics."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}:automationRunAggregates":{"get":{"summary":"Query Automation Run Aggregates","operationId":"QueryAutomationRunAggregates","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1QueryAutomationRunAggregatesResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}}],"tags":["Runs"]}}}}
```

## GET /api/v1/organizations/{organization\_id}/workspaces/{workspace\_id}:dailyRunAggregates

> Query Daily Run Aggregates

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1QueryDailyRunAggregatesResponse":{"type":"object","properties":{"daily_run_aggregates":{"type":"array","items":{"$ref":"#/components/schemas/v1DailyRunAggregateEntry"},"description":"List of daily run statistics entries.","readOnly":true}},"description":"Response message for QueryDailyRunAggregates method.\nContains daily run statistics as a list of entries."},"v1DailyRunAggregateEntry":{"type":"object","properties":{"date":{"type":"string","description":"The date for this entry.\nFormat: YYYY-MM-DD (e.g., \"2024-01-01\"). Using google.type.Date causing issue while transcoding to json.","readOnly":true},"stats":{"$ref":"#/components/schemas/v1DailyRunAggregate"}},"description":"Entry for daily run statistics.\nContains the date and run counts for that date."},"v1DailyRunAggregate":{"type":"object","properties":{"total_runs":{"type":"integer","format":"int32","description":"The total number of runs created on this date.","readOnly":true}},"description":"Stats for a single day.\nContains run counts for all runs in the workspace on that date."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}:dailyRunAggregates":{"get":{"summary":"Query Daily Run Aggregates","operationId":"QueryDailyRunAggregates","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1QueryDailyRunAggregatesResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"start_date.year","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"start_date.month","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"start_date.day","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"end_date.year","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"end_date.month","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"end_date.day","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"time_zone","description":"Time zone for date aggregation.\nFormat: IANA timezone identifier (e.g., \"America/New_York\", \"UTC\", \"Europe/London\")","in":"query","required":true,"schema":{"type":"string"}},{"name":"filter","description":"Filter expression for filtering runs included in the aggregation.\nFollows the structured syntax defined in AIP-160.\n\nSupported fields for filtering:\n- automation_id: The unique identifier of the automation (string)\n\nSupported operators:\n- Comparison: =\n- Logical: OR\n\nExamples:\n- Filter by specific automation:\n  \"automation_id = \\\"789\\\"\"\n- Filter by multiple automations:\n  \"automation_id = \\\"789\\\" OR automation_id = \\\"790\\\"\"\n\nIf an invalid filter expression is provided, the API will return INVALID_ARGUMENT.","in":"query","required":false,"schema":{"type":"string"}}],"tags":["Runs"]}}}}
```

## GET /api/v1/organizations/{organization\_id}/workspaces/{workspace\_id}/executions/{execution\_id}/outputs

> Get Execution Outputs

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1GetExecutionOutputsResponse":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1ExecutionOutput"},"description":"Map of named output values set by the set_output() builtin function during execution.\nThe key is the output name (string) and the value is the ExecutionOutput containing\nthe value and type set by calling set_output(name, value).\nThis map will be empty if no set_output() calls were made during execution."}},"description":"GetExecutionOutputsResponse contains the outputs from a completed execution."},"v1ExecutionOutput":{"type":"object","properties":{"value":{"$ref":"#/components/schemas/commonV1Value"},"type":{"$ref":"#/components/schemas/v1ValueType"}},"description":"ExecutionOutput represents an output value set by the set_output() builtin function during execution."},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/executions/{execution_id}/outputs":{"get":{"summary":"Get Execution Outputs","operationId":"GetExecutionOutputs","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1GetExecutionOutputsResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"execution_id","in":"path","required":true,"schema":{"type":"string"}}],"tags":["Runs"]}}}}
```

## List Run Events

> This RPC retrieves a paginated list of all events that occurred during\
> a specific automation run. Events are returned in the order they were\
> generated, providing a complete timeline of the run's execution.\
> \
> Use the filter parameter to narrow results by specific criteria such as\
> node\_kind for execution journal events.\
> \
> The response includes both high-level run state changes (starts, completions,\
> failures) and detailed execution steps (node executions, execution patches,\
> detailed data flows in each expression, etc).

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1ListRunEventsResponse":{"type":"object","properties":{"run_events":{"type":"array","items":{"$ref":"#/components/schemas/v1RunEvent"},"description":"The list of run events for the requested page.\n\nEvents are returned in the order specified by the request's order_by\nfield (default: chronological / oldest first). Each event contains either:\n- A run state update from the Jeeves orchestration service\n- An execution journal entry from the Jarvis execution engine"},"next_page_token":{"type":"string","description":"Pagination token for retrieving the next page of events.\n\nInclude this token as the `page_token` in a subsequent ListRunEvents\nrequest to retrieve the next set of events. The token maintains\ncursor position and ensures consistent pagination even if new\nevents are added to the run.\n\nWhen this field is empty or omitted:\n- This is the final page of results\n- All events for the run have been retrieved\n- No further pagination requests are needed\n\nThe token is opaque. Do not attempt to parse, modify, or reuse tokens\nacross different parent resources or request parameters."}},"description":"Response message for the ListRunEvents RPC.\n\nContains a page of run events along with pagination information for\nretrieving additional events. Events are sorted by their occurrence time\nin the direction specified by the request's order_by field (default:\nascending / oldest first).\n\nThe response may contain fewer events than requested if:\n- The run has fewer remaining events than the page size\n- This is the final page of results\n- Response size limits are reached"},"v1RunEvent":{"type":"object","properties":{"run_update":{"$ref":"#/components/schemas/v1RunUpdate"},"execution_journal":{"$ref":"#/components/schemas/v1ExecutionJournal"}},"description":"A single event that occurred during an automation run execution."},"v1RunUpdate":{"type":"object","properties":{"run":{"$ref":"#/components/schemas/v1Run"}},"description":"RunUpdate represents a single update to a run's state."},"v1Run":{"type":"object","properties":{"name":{"type":"string","title":"The name of the run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"executable_steps":{"$ref":"#/components/schemas/v1ExecutableSteps"},"create_time":{"type":"string","format":"date-time","description":"The timestamp when this run was created.\nSet automatically when the run is first submitted to the system.","readOnly":true},"state":{"$ref":"#/components/schemas/v1RunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when this run was updated.\nSet automatically when the run is updated.","readOnly":true},"previous_run":{"type":"string","title":"The name of the previous run in the chain, if applicable.\nExecution details of the previous run may be used to avoid re-computation.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"stage_version":{"type":"string","description":"The version of the automation stage at the time this run was created."},"invocation_details":{"$ref":"#/components/schemas/v1InvocationDetails"},"user_inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The user inputs provided to the run during pre phase and will be available for the UI to display the user inputs."},"root_run":{"type":"string","title":"The first run in this run's replay lineage. A run created fresh is its own\nroot; a run created by ReplayRun shares its source run's root. Lets a whole\nreplay lineage be fetched in one query (ListRuns filtered by root_run), and\ntop-level runs be listed by filtering for an empty previous_run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}","readOnly":true},"disable_exception_handling":{"type":"boolean","description":"Whether to disable exception creation and handling when this run encounters guidance\nand enters the Awaiting Guidance state.\nApplies only to draft-stage runs. Published-stage runs always use standard Astral exception handling."},"enable_astral_on_rain":{"type":"boolean","description":"Whether exception handling should be performed by the Astral agent deployed\non the Rain agent framework."},"active_step_index":{"type":"integer","format":"int32","description":"The zero-based index of the step currently executing within executable_steps.\nAbsent when executable_steps is empty (single-step runs without a pre-phase).","readOnly":true},"archived_time":{"type":"string","format":"date-time","description":"The timestamp when this run was archived, if it has been archived.\nWhen set, the run cannot be mutated (pause, resume, skip, patch, retry).\nThe state field continues to reflect the real terminal execution state.","readOnly":true},"content_coverage":{"$ref":"#/components/schemas/v1RunContentCoverage"}},"description":"Run represents a single execution instance of code in the Jeeves platform.\nContains the executable code, metadata, and current execution state.","required":["stage","stage_version"]},"v1ExecutableSteps":{"type":"object","properties":{"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Input parameters for the execution, provided as name-value pairs.\nThese variables will be available to the code during execution."},"executables":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutableStep"},"description":"The source code to be executed, written in SPy (Simplified Python) language."}},"description":"ExecutableSteps represents a sequence of steps of execution of a run. Each step is\na separate computable unit with its own code, book connections and optional inputs.\nThe first step may optionally have an input provided to it when the run is invoked.\nThe output of each step becomes the input of the next step and the output of the\nlast step becomes the output of the run.","required":["executables"]},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1ExecutableStep":{"type":"object","properties":{"code":{"type":"string","description":"The source code to be executed, written in SPy (Simplified Python) language.\nThis is the main logic that will be interpreted and run by the execution engine."},"book_connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections required by this executable.\nMaps connection names to their specific ID and endpoints."},"phase_type":{"$ref":"#/components/schemas/v1AutomationPhaseType"},"collections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1CollectionRef"},"description":"Collections referenced by this step.\nMaps each collection slug to its reference."},"index":{"type":"integer","format":"int32","description":"Zero-based position of this step within executable_steps.","readOnly":true},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Business-tunable config for this step, keyed by config name and resolved to\nplain values. Read in SPy as kognitos.config.<name>."}},"description":"ExecutableStep represents a piece of code that can be executed in the Jeeves platform.\nContains the source code, input parameters, and external dependencies needed for execution.","required":["code","phase_type"]},"v1BookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"Unique identifier for this connection resource."},"endpoint":{"type":"string","description":"Endpoint for the connection."}},"description":"BookConnection is a resource representing a connection to a book instance.\nA connection has a unique identifier and an endpoint."},"v1AutomationPhaseType":{"type":"string","enum":["AUTOMATION_PHASE_TYPE_UNSPECIFIED","AUTOMATION_PHASE_TYPE_PRE","AUTOMATION_PHASE_TYPE_MAIN","AUTOMATION_PHASE_TYPE_POST"],"default":"AUTOMATION_PHASE_TYPE_UNSPECIFIED","description":"PhaseType defines the type of phase for an automation trigger.\n\n - AUTOMATION_PHASE_TYPE_UNSPECIFIED: Unspecified phase type.\n - AUTOMATION_PHASE_TYPE_PRE: Pre-processing phase.\n - AUTOMATION_PHASE_TYPE_MAIN: Main processing phase.\n - AUTOMATION_PHASE_TYPE_POST: Post-processing phase."},"v1CollectionRef":{"type":"object","properties":{"collection_id":{"type":"string","description":"The Bishop collection id that this slug resolves to."},"stage":{"$ref":"#/components/schemas/v1CollectionStage"}},"description":"CollectionRef references a first-class collection by the id it resolves to."},"v1CollectionStage":{"type":"string","enum":["COLLECTION_STAGE_UNSPECIFIED","COLLECTION_STAGE_DRAFT","COLLECTION_STAGE_PUBLISHED"],"default":"COLLECTION_STAGE_UNSPECIFIED","description":"CollectionStage identifies which stage of a collection a request targets.\n\n - COLLECTION_STAGE_UNSPECIFIED: Stage not specified.\n - COLLECTION_STAGE_DRAFT: The draft stage.\n - COLLECTION_STAGE_PUBLISHED: The published stage."},"v1RunState":{"type":"object","properties":{"pending":{"$ref":"#/components/schemas/v1PendingRunState"},"executing":{"$ref":"#/components/schemas/v1ExecutingRunState"},"stopping":{"$ref":"#/components/schemas/v1StoppingRunState"},"stopped":{"$ref":"#/components/schemas/v1StoppedRunState"},"awaiting_guidance":{"$ref":"#/components/schemas/v1AwaitingGuidanceRunState"},"completed":{"$ref":"#/components/schemas/v1CompletedRunState"},"failed":{"$ref":"#/components/schemas/v1FailedRunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when the run transitioned to this state.","readOnly":true},"archived":{"$ref":"#/components/schemas/v1ArchivedRunState"},"awaiting_answer":{"$ref":"#/components/schemas/v1AwaitingAnswerRunState"}},"description":"RunState represents the overall lifecycle state of a run.\nTracks the run from initial submission through completion or failure."},"v1PendingRunState":{"type":"object","description":"Run has been submitted and is waiting to start execution.\nThe run is queued and will begin when resources become available."},"v1ExecutingRunState":{"type":"object","description":"Run is currently being executed.\nCode is actively running and making progress."},"v1StoppingRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run is in the process of being stopped.\nExecution is stopping gracefully and will transition to STOPPED state."},"v1StoppedRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run has been stopped and can be resumed later.\nExecution is temporarily stopped but can continue from current state."},"v1AwaitingGuidanceRunState":{"type":"object","properties":{"exception":{"type":"string","title":"ID of the exception (from guidance center)","readOnly":true},"description":{"type":"string","description":"Description of the exception that occured.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"},"rain_thread_id":{"type":"string","description":"The Rain thread ID for this exception on the Astral-on-Rain path. Each\nexception gets its own Rain thread so clients can subscribe to just this\nexception's events. Empty on the local path or when Rain is disabled.","readOnly":true}},"description":"Run is waiting for external guidance or user input.\nRequires manual intervention or external decision to proceed."},"commonV1Location":{"type":"object","properties":{"start_byte":{"type":"string","format":"int64","title":"Starting Byte of the span, It will be zero-based"},"end_byte":{"type":"string","format":"int64","title":"Ending Byte(exclusive) of the span, It will be zero-based"},"start_position":{"$ref":"#/components/schemas/v1Position"},"end_position":{"$ref":"#/components/schemas/v1Position"}},"description":"Location represents a generic span within some underlying content.\nIt specifies the starting byte offset and the ending byte offset (exclusive) of the span.\nThis can be used for pointing to regions in files, buffers, logs, messages,\nor any other byte-addressable resource."},"v1Position":{"type":"object","properties":{"line":{"type":"integer","format":"int32","description":"0-based line number."},"column":{"type":"integer","format":"int32","description":"0-based column offset (bytes from line start)."}},"description":"A position in a text document expressed as 0-based line and column."},"v1CompletedRunState":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The outputs of the run.","readOnly":true}},"description":"Run has completed successfully.\nAll code has been executed and results are available."},"v1FailedRunState":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the error that caused the run to fail.","readOnly":true},"description":{"type":"string","description":"The description of the error.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"}},"description":"Run has failed due to an error.\nExecution stopped due to an unrecoverable error condition."},"v1ArchivedRunState":{"type":"object","description":"Run has been archived by the user.\nThe run is preserved for historical reference but cannot be modified,\nresumed, or mutated in any way."},"v1AwaitingAnswerRunState":{"type":"object","properties":{"invocation_id":{"type":"string","description":"Identity of the ask() invocation the run is waiting on.","readOnly":true},"question_key":{"type":"string","description":"Author-supplied key identifying the recurring logical question.","readOnly":true},"prompt":{"type":"string","description":"The question shown to the person.","readOnly":true},"form":{"$ref":"#/components/schemas/v1FormSpec"},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Supporting values frozen with the question.","readOnly":true}},"description":"Run is intentionally waiting for a person to answer an ask() question.\nThis is planned waiting, not a failure or an exception: the run resumes once\nthe question is answered through the authoring experience or Workbench."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1AutomationStage":{"type":"string","enum":["AUTOMATION_STAGE_UNSPECIFIED","AUTOMATION_STAGE_DRAFT","AUTOMATION_STAGE_PUBLISHED"],"default":"AUTOMATION_STAGE_UNSPECIFIED","description":"AutomationStage represents the publication stage of an automation.\nThis enum is shared across services that manage or execute automations.\n\n - AUTOMATION_STAGE_UNSPECIFIED: Automation stage is not specified.\n - AUTOMATION_STAGE_DRAFT: Automation is in draft stage and can be modified.\n - AUTOMATION_STAGE_PUBLISHED: Automation is published and immutable, ready for execution."},"v1InvocationDetails":{"type":"object","properties":{"trigger_id":{"type":"string","description":"The ID of the trigger that initiated this run, if applicable."},"user_id":{"type":"string","description":"The ID of the user that initiated this run, if applicable."},"invocation_source":{"$ref":"#/components/schemas/v1InvocationSource"}},"description":"InvocationDetails contains additional information about the entity that initiated a run."},"v1InvocationSource":{"type":"string","enum":["INVOCATION_SOURCE_UNSPECIFIED","INVOCATION_SOURCE_MANUAL","INVOCATION_SOURCE_TRIGGER","INVOCATION_SOURCE_SCHEDULE","INVOCATION_SOURCE_PAT","INVOCATION_SOURCE_TEST"],"default":"INVOCATION_SOURCE_UNSPECIFIED","description":"InvocationSource identifies the entity responsible for creating a run.\n\n - INVOCATION_SOURCE_UNSPECIFIED: Unspecified invocation source.\n - INVOCATION_SOURCE_MANUAL: Run was manually initiated by a user.\n - INVOCATION_SOURCE_TRIGGER: Run was triggered by an event or trigger.\n - INVOCATION_SOURCE_SCHEDULE: Run was initiated by a schedule.\n - INVOCATION_SOURCE_PAT: Run was initiated via a Personal Access Token (PAT).\n - INVOCATION_SOURCE_TEST: Run was initiated by Quill agent for testing draft automations."},"v1RunContentCoverage":{"type":"object","properties":{"file_count":{"type":"integer","format":"int32","description":"The number of files found in the run.","readOnly":true},"indexed_file_count":{"type":"integer","format":"int32","description":"The number of files whose text is searchable.","readOnly":true},"partially_indexed_file_count":{"type":"integer","format":"int32","description":"The number of indexed files that are only partly searchable, because their\ntext was cut off at a size limit or some of their pages have no text layer.\nThese files are also counted in indexed_file_count, so this is never larger.","readOnly":true},"pending_file_count":{"type":"integer","format":"int32","description":"The number of files not indexed yet: waiting, being read, or due for a\nretry after a temporary error.","readOnly":true},"skipped_file_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1SkippedFileCount"},"description":"The files that will not be indexed, counted by reason. Holds one entry for\neach reason that applies to at least one file, in no particular order.","readOnly":true}},"description":"RunContentCoverage counts a run's files by whether the ListRuns search filter\nterm can match the text inside them.\n\nThe files counted are those in the run's inputs, outputs and trigger payload,\nthe files its steps used as recorded in the Run log, and text values offloaded\nto object storage. Text the steps produced is not a file and is not counted. A\nfile is counted once however many places it appears in, and in exactly one of\nindexed_file_count, pending_file_count and skipped_file_counts, so file_count\nis their sum. The counts cover the files found so far: a run that is still\nexecuting, or whose Run log has not been read yet, can gain files later."},"v1SkippedFileCount":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/v1ContentSkipReason"},"file_count":{"type":"integer","format":"int32","description":"The number of files skipped for this reason.","readOnly":true}},"description":"The number of a run's files that content search skipped for one reason."},"v1ContentSkipReason":{"type":"string","enum":["CONTENT_SKIP_REASON_UNSPECIFIED","CONTENT_SKIP_REASON_NO_TEXT_LAYER","CONTENT_SKIP_REASON_TOO_LARGE","CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT","CONTENT_SKIP_REASON_ENCRYPTED","CONTENT_SKIP_REASON_FAILED","CONTENT_SKIP_REASON_TOO_MANY_FILES","CONTENT_SKIP_REASON_INACCESSIBLE"],"default":"CONTENT_SKIP_REASON_UNSPECIFIED","description":"Why content search will not index one of a run's files.\nMore reasons may be added; treat a value you do not recognize as a file that\nis not searchable for an unstated reason.\n\n - CONTENT_SKIP_REASON_UNSPECIFIED: Unspecified reason. Not returned by the server.\n - CONTENT_SKIP_REASON_NO_TEXT_LAYER: The file has no text layer, such as an image or a scanned PDF. Content\nsearch does not run OCR.\n - CONTENT_SKIP_REASON_TOO_LARGE: The file is larger than content search reads. A file that is only cut off\nat a limit is indexed instead, and counted in\nRunContentCoverage.partially_indexed_file_count.\n - CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT: Content search cannot read the file's format, such as a legacy Word or\nPowerPoint document, an Outlook message, or an archive.\n - CONTENT_SKIP_REASON_ENCRYPTED: The file is password-protected.\n - CONTENT_SKIP_REASON_FAILED: Reading the file failed and will not be retried, for example because the\nfile is corrupt, or reading it kept crashing or timing out.\n - CONTENT_SKIP_REASON_TOO_MANY_FILES: The run has more files than content search indexes for a single run, and\nthis file is beyond that limit.\n - CONTENT_SKIP_REASON_INACCESSIBLE: The file cannot be read from this run: it no longer exists, or the run\nrefers to it somewhere content search does not follow, such as another\nworkspace."},"v1ExecutionJournal":{"type":"object","properties":{"execution_id":{"type":"string","title":"Unique identifier for the execution"},"run_id":{"type":"string","title":"Optional: Run identifier, set if the execution is part of a run"},"event_time":{"type":"string","format":"date-time","title":"When this journal entry was generated"},"started":{"$ref":"#/components/schemas/v1ExecutionStarted"},"completed":{"$ref":"#/components/schemas/v1ExecutionCompleted"},"stopped":{"$ref":"#/components/schemas/v1ExecutionStopped"},"failed":{"$ref":"#/components/schemas/v1ExecutionFailed"},"node_started":{"$ref":"#/components/schemas/v1NodeStarted"},"node_executed":{"$ref":"#/components/schemas/v1NodeExecuted"},"node_skipped":{"$ref":"#/components/schemas/v1NodeSkipped"},"node_patched":{"$ref":"#/components/schemas/v1NodePatched"},"patched_node_started":{"$ref":"#/components/schemas/v1PatchedNodeStarted"},"patched_node_executed":{"$ref":"#/components/schemas/v1PatchedNodeExecuted"},"automation_id":{"type":"string","title":"Optional: Automation identifier, set if the execution is part of an automation"},"automation_phase_id":{"type":"string","title":"Optional: Automation phase identifier, set if the execution is part of an automation phase"},"code_hash":{"type":"string","title":"Optional: MD5 hash of the SPy code being executed"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"workspace_id":{"type":"string","title":"The workspace id for which the execution is requested"},"organization_id":{"type":"string","title":"The organization id for which the execution is requested"},"extra_metadata":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Optional extra metadata to be stored with the execution\nThis will be used to pass the additional information that downstream services might require\nbut there is no need to Jarvis to know about it."}},"title":"Journal event for an execution, capturing status and node-level events"},"v1ExecutionStarted":{"type":"object","description":"ExecutionStarted indicates that Jarvis has started the execution."},"v1ExecutionCompleted":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Map of named output values set by the set_output() builtin function during execution.\nEach entry is a name-value pair where the key is the output name (string) and\nthe value is the output value set by calling set_output(name, value).\nThis map will be empty if no set_output() calls were made during execution."},"return_value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"ExecutionCompleted indicates that Jarvis has successfully completed the execution.\nThe final result value is included in this message, representing the return value of\nthe executed code."},"v1ExecutionStopped":{"type":"object","properties":{"user_stopped":{"$ref":"#/components/schemas/v1UserStopped"},"waiting_on_book":{"$ref":"#/components/schemas/v1WaitingOnBook"},"waiting_on_timer":{"$ref":"#/components/schemas/v1WaitingOnTimer"},"program_stopped":{"$ref":"#/components/schemas/v1ProgramStopped"}},"description":"ExecutionStopped indicates that the execution was stopped before completion due to\na specific reason."},"v1UserStopped":{"type":"object","description":"UserStopped indicates that the execution was stopped by a user."},"v1WaitingOnBook":{"type":"object","description":"WaitingOnBook indicates that the execution is stopped because its\nwaiting on an async book procedure to complete. The run manager is expected\nto resume the execution when the book procedure completes."},"v1WaitingOnTimer":{"type":"object","properties":{"duration":{"type":"string","description":"The duration of the timer."}},"description":"WaitingOnTimer indicates that the execution is stopped because its\nwaiting for a timer to fire. The run manager is expected to resume the\nexecution when the timer fires."},"v1ProgramStopped":{"type":"object","properties":{"reason":{"type":"string","description":"The reason the program was stopped."}},"description":"ProgramStopped indicates that the execution was stopped by the program."},"v1ExecutionFailed":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/v1ExecutionError"}},"description":"ExecutionFailed indicates that the execution encountered an error and\ncould not complete successfully."},"v1ExecutionError":{"type":"object","properties":{"id":{"type":"string","title":"Unique identifier for the error"},"description":{"type":"string","title":"Human-readable description of what went wrong"},"context":{"$ref":"#/components/schemas/v1Context"},"extra":{"type":"object","additionalProperties":{"type":"string"},"title":"Extra information about the error"},"code":{"type":"string","title":"The code where the error was raised (includes patches)\nIf the error was raised in a patch, the code reflects the patched code\nand the error location is relative to the patched code instead of the original\ncode\nNote: this field does not include previous patches that executed successfully"},"typed_extra":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"title":"Extra information about the error, as typed values that may be offloaded"}},"description":"ExecutionError represents an error that occurred during execution."},"v1Context":{"type":"object","properties":{"code_location":{"$ref":"#/components/schemas/commonV1Location"},"node_id":{"type":"string","title":"The id of node"},"connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections active at the time of failure (connection name → connection details).\nAllows consumers to know which connections were available when the error occurred,\nwhich is useful for re-submitting a resume with the correct connection IDs."},"runtime_values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Runtime values of the variables used by the sentence that failed\n(variable name → value)."},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Read-only config values active at the time of failure (config name → value).\nMirrors `connections`: lets consumers see the config the SPy code read via\nkognitos.config.<name> when re-submitting a resume."}},"description":"Context provides additional information about the execution environment,\nsuch as stack traces for debugging purposes."},"v1NodeStarted":{"type":"object","properties":{"code_location":{"$ref":"#/components/schemas/commonV1Location"},"node_id":{"type":"string","title":"The id of the node that was started"},"node_kind":{"type":"string","title":"The kind/type of the node that was started"}},"title":"Event emitted when Jarvis begins executing an AST node"},"v1NodeExecuted":{"type":"object","properties":{"code_location":{"$ref":"#/components/schemas/commonV1Location"},"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The input variables & their values\nA variable is defined as an input if it was fetched\nfrom the memory while executing the node or one of its\nchildren."},"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The output variables & their values\nA variable is defined as an output if it was written to\nthe memory while executing the node or one of its\nchildren.\nIf a variable was written multiple times, only the last\nwritten value is considered as the output."},"error":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutionError"},"description":"The list of all the errors that occurred while executing the\nnode or any of its children."},"node_id":{"type":"string","title":"The id of the node that got executed"},"book_function_call":{"$ref":"#/components/schemas/v1BookFunctionCall"},"node_kind":{"type":"string","title":"The kind/type of the node that was executed"},"function_call_context":{"$ref":"#/components/schemas/v1FunctionCallContext"}},"title":"Event emitted after Jarvis finishes executing an AST node, with I/O and errors"},"v1BookFunctionCall":{"type":"object","properties":{"book_function":{"$ref":"#/components/schemas/v1BookFunction"},"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"title":"The input variables and their values passed to the book function"},"output":{"$ref":"#/components/schemas/commonV1Value"}},"description":"BookFunctionCall represents a call to an external book function with its inputs and outputs."},"v1BookFunction":{"type":"object","properties":{"connection_spy_identifier":{"type":"string","title":"The connection name for the book instance in the spy code"},"book_name":{"type":"string","title":"The name of the target book containing the function"},"function_name":{"type":"string","title":"The name of the specific function to invoke within the book"},"code_location":{"$ref":"#/components/schemas/commonV1Location"}},"description":"BookFunction represents a reference to an external book function."},"v1FunctionCallContext":{"type":"object","properties":{"function_name":{"type":"string","title":"The name of the function that was called"},"input_args":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"title":"The named input parameters passed to the function (parameter name → value)"},"return_value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"FunctionCallContext captures the semantic details of a function call:\nthe function name, its named arguments, and the return value.\nPopulated for any statement whose execution involved a function call\n(user-defined, builtin, or book function)."},"v1NodeSkipped":{"type":"object","properties":{"code_location":{"$ref":"#/components/schemas/commonV1Location"},"node_id":{"type":"string","title":"The id of the node that was skipped"},"node_kind":{"type":"string","title":"The kind/type of the node that was skipped"}},"title":"Event emitted when Jarvis skips executing an AST node"},"v1NodePatched":{"type":"object","properties":{"code_location":{"$ref":"#/components/schemas/commonV1Location"},"code_patch":{"type":"string","title":"The patch SPy code that was applied"},"inputs_patch":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"title":"The execution inputs that were patched"},"connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"title":"The book connections that were patched\nThe key is the name of the connection used in the SPy code\nThe value contains the connection details"},"node_id":{"type":"string","title":"The id of the node"},"node_kind":{"type":"string","title":"The kind/type of the node that was patched"}},"title":"Event emitted when a patch is applied to an AST node"},"v1PatchedNodeStarted":{"type":"object","properties":{"patch_location":{"$ref":"#/components/schemas/commonV1Location"},"node_location":{"$ref":"#/components/schemas/commonV1Location"},"node_id":{"type":"string","title":"The id of the patched node for which execution is starting"},"node_kind":{"type":"string","title":"The kind/type of the patched node that is being started"}},"title":"Event emitted when Jarvis starts executing a node inside a patch"},"v1PatchedNodeExecuted":{"type":"object","properties":{"patch_location":{"$ref":"#/components/schemas/commonV1Location"},"node_location":{"$ref":"#/components/schemas/commonV1Location"},"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The input variables & their values\nA variable is defined as an input if it was fetched\nfrom the memory while executing the node or one of its\nchildren."},"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The output variables & their values\nA variable is defined as an output if it was written to\nthe memory while executing the node or one of its\nchildren.\nIf a variable was written multiple times, only the last\nwritten value is considered as the output."},"error":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutionError"},"description":"The list of all the errors that occurred while executing the\nnode or any of its children."},"node_id":{"type":"string","title":"The id of the patched node for which execution is completed"},"book_function_call":{"$ref":"#/components/schemas/v1BookFunctionCall"},"node_kind":{"type":"string","title":"The kind/type of the patched node that was executed"},"function_call_context":{"$ref":"#/components/schemas/v1FunctionCallContext"}},"title":"Event emitted after executing a node inside a patch, with I/O and errors"},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}/events":{"get":{"summary":"List Run Events","description":"This RPC retrieves a paginated list of all events that occurred during\na specific automation run. Events are returned in the order they were\ngenerated, providing a complete timeline of the run's execution.\n\nUse the filter parameter to narrow results by specific criteria such as\nnode_kind for execution journal events.\n\nThe response includes both high-level run state changes (starts, completions,\nfailures) and detailed execution steps (node executions, execution patches,\ndetailed data flows in each expression, etc).","operationId":"ListRunEvents","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1ListRunEventsResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page_size","description":"Maximum number of run events to return in a single response.\n\nThe service may return fewer events than requested, but will never\nreturn more. This can happen when:\n- The run has fewer total events than requested\n- Internal chunking limits are reached\n- The remaining events don't fit in the response size limit\n\nValid range: 1-1000 events\nDefault: 100 events if unspecified\nValues above 1000 are automatically capped at 1000\nNegative values result in an INVALID_ARGUMENT error","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"page_token","description":"Pagination token from a previous ListRunEvents response.\n\nProvide the `next_page_token` value from a previous response to\ncontinue retrieving the next set of events. Leave empty or unset\nfor the first page of results.\n\nThe token is opaque and should not be parsed or modified by clients.","in":"query","required":false,"schema":{"type":"string"}},{"name":"filter","description":"Filter expression to narrow down which events are returned.\n\nUses AIP-160 filtering syntax (https://google.aip.dev/160).\n\nSupported fields:\n  node_kind   (string)  — AST node kind, e.g. node_kind = \"FunctionCall\"\n  start_line  (integer) — 0-based start line of the node's source location\n  end_line    (integer) — 0-based end line (exclusive) of the node's source location\n\nEvents without the filtered field are excluded from results.\nWhen empty or unset, all events for the specified run are returned.","in":"query","required":false,"schema":{"type":"string"}},{"name":"order_by","description":"Ordering of the returned events.\n\nFollows AIP-132 syntax (https://google.aip.dev/132#ordering).\nThe only sortable field is \"time\" (the event timestamp).\n\nAccepted values: \"time asc\" or \"time desc\".\nDefault: \"time asc\" (chronological order, oldest first).\n\nExample: order_by=\"time desc\" returns newest events first.\n\nPagination cursors are direction-aware: a page_token obtained with one\nordering must not be reused with a different ordering.","in":"query","required":false,"schema":{"type":"string"}}],"tags":["Runs"]}}}}
```

## List Run Answers

> Lists accepted answers submitted in the draft/test authoring experience.\
> Answers are ordered by submission time, oldest first.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1ListRunAnswersResponse":{"type":"object","properties":{"run_answers":{"type":"array","items":{"$ref":"#/components/schemas/v1RunAnswer"},"description":"The accepted answers in this page."},"next_page_token":{"type":"string","description":"Token for the next page, or empty when there are no more answers."}},"description":"A page of accepted authoring answers, oldest first."},"v1RunAnswer":{"type":"object","properties":{"invocation_id":{"type":"string","description":"Identity of the ask invocation that was answered.","readOnly":true},"question_key":{"type":"string","description":"Author-supplied key of the recurring question.","readOnly":true},"prompt":{"type":"string","description":"The original question shown to the person.","readOnly":true},"form":{"$ref":"#/components/schemas/v1FormSpec"},"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"The values accepted for the form fields.","readOnly":true},"submit_time":{"type":"string","format":"date-time","description":"When the answer was durably accepted.","readOnly":true},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Read-only evidence frozen with the original question.","readOnly":true}},"description":"A durable accepted answer and the frozen question it answered."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}/answers":{"get":{"summary":"List Run Answers","description":"Lists accepted answers submitted in the draft/test authoring experience.\nAnswers are ordered by submission time, oldest first.","operationId":"ListRunAnswers","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1ListRunAnswersResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page_size","description":"Maximum number to return. Defaults to 50 and is capped at 100.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"page_token","description":"Token from the previous response for this run.","in":"query","required":false,"schema":{"type":"string"}}],"tags":["Runs"]}}}}
```

## Answer Run

> Answers the current question of a draft run or an explicit test run.\
> Published operational runs must be answered through Workbench.\
> Repeating the same answer for the same invocation is idempotent; a conflicting\
> answer, stale invocation, or stopped run is rejected without resuming it.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1Run":{"type":"object","properties":{"name":{"type":"string","title":"The name of the run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"executable_steps":{"$ref":"#/components/schemas/v1ExecutableSteps"},"create_time":{"type":"string","format":"date-time","description":"The timestamp when this run was created.\nSet automatically when the run is first submitted to the system.","readOnly":true},"state":{"$ref":"#/components/schemas/v1RunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when this run was updated.\nSet automatically when the run is updated.","readOnly":true},"previous_run":{"type":"string","title":"The name of the previous run in the chain, if applicable.\nExecution details of the previous run may be used to avoid re-computation.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"stage_version":{"type":"string","description":"The version of the automation stage at the time this run was created."},"invocation_details":{"$ref":"#/components/schemas/v1InvocationDetails"},"user_inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The user inputs provided to the run during pre phase and will be available for the UI to display the user inputs."},"root_run":{"type":"string","title":"The first run in this run's replay lineage. A run created fresh is its own\nroot; a run created by ReplayRun shares its source run's root. Lets a whole\nreplay lineage be fetched in one query (ListRuns filtered by root_run), and\ntop-level runs be listed by filtering for an empty previous_run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}","readOnly":true},"disable_exception_handling":{"type":"boolean","description":"Whether to disable exception creation and handling when this run encounters guidance\nand enters the Awaiting Guidance state.\nApplies only to draft-stage runs. Published-stage runs always use standard Astral exception handling."},"enable_astral_on_rain":{"type":"boolean","description":"Whether exception handling should be performed by the Astral agent deployed\non the Rain agent framework."},"active_step_index":{"type":"integer","format":"int32","description":"The zero-based index of the step currently executing within executable_steps.\nAbsent when executable_steps is empty (single-step runs without a pre-phase).","readOnly":true},"archived_time":{"type":"string","format":"date-time","description":"The timestamp when this run was archived, if it has been archived.\nWhen set, the run cannot be mutated (pause, resume, skip, patch, retry).\nThe state field continues to reflect the real terminal execution state.","readOnly":true},"content_coverage":{"$ref":"#/components/schemas/v1RunContentCoverage"}},"description":"Run represents a single execution instance of code in the Jeeves platform.\nContains the executable code, metadata, and current execution state.","required":["stage","stage_version"]},"v1ExecutableSteps":{"type":"object","properties":{"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Input parameters for the execution, provided as name-value pairs.\nThese variables will be available to the code during execution."},"executables":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutableStep"},"description":"The source code to be executed, written in SPy (Simplified Python) language."}},"description":"ExecutableSteps represents a sequence of steps of execution of a run. Each step is\na separate computable unit with its own code, book connections and optional inputs.\nThe first step may optionally have an input provided to it when the run is invoked.\nThe output of each step becomes the input of the next step and the output of the\nlast step becomes the output of the run.","required":["executables"]},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1ExecutableStep":{"type":"object","properties":{"code":{"type":"string","description":"The source code to be executed, written in SPy (Simplified Python) language.\nThis is the main logic that will be interpreted and run by the execution engine."},"book_connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections required by this executable.\nMaps connection names to their specific ID and endpoints."},"phase_type":{"$ref":"#/components/schemas/v1AutomationPhaseType"},"collections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1CollectionRef"},"description":"Collections referenced by this step.\nMaps each collection slug to its reference."},"index":{"type":"integer","format":"int32","description":"Zero-based position of this step within executable_steps.","readOnly":true},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Business-tunable config for this step, keyed by config name and resolved to\nplain values. Read in SPy as kognitos.config.<name>."}},"description":"ExecutableStep represents a piece of code that can be executed in the Jeeves platform.\nContains the source code, input parameters, and external dependencies needed for execution.","required":["code","phase_type"]},"v1BookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"Unique identifier for this connection resource."},"endpoint":{"type":"string","description":"Endpoint for the connection."}},"description":"BookConnection is a resource representing a connection to a book instance.\nA connection has a unique identifier and an endpoint."},"v1AutomationPhaseType":{"type":"string","enum":["AUTOMATION_PHASE_TYPE_UNSPECIFIED","AUTOMATION_PHASE_TYPE_PRE","AUTOMATION_PHASE_TYPE_MAIN","AUTOMATION_PHASE_TYPE_POST"],"default":"AUTOMATION_PHASE_TYPE_UNSPECIFIED","description":"PhaseType defines the type of phase for an automation trigger.\n\n - AUTOMATION_PHASE_TYPE_UNSPECIFIED: Unspecified phase type.\n - AUTOMATION_PHASE_TYPE_PRE: Pre-processing phase.\n - AUTOMATION_PHASE_TYPE_MAIN: Main processing phase.\n - AUTOMATION_PHASE_TYPE_POST: Post-processing phase."},"v1CollectionRef":{"type":"object","properties":{"collection_id":{"type":"string","description":"The Bishop collection id that this slug resolves to."},"stage":{"$ref":"#/components/schemas/v1CollectionStage"}},"description":"CollectionRef references a first-class collection by the id it resolves to."},"v1CollectionStage":{"type":"string","enum":["COLLECTION_STAGE_UNSPECIFIED","COLLECTION_STAGE_DRAFT","COLLECTION_STAGE_PUBLISHED"],"default":"COLLECTION_STAGE_UNSPECIFIED","description":"CollectionStage identifies which stage of a collection a request targets.\n\n - COLLECTION_STAGE_UNSPECIFIED: Stage not specified.\n - COLLECTION_STAGE_DRAFT: The draft stage.\n - COLLECTION_STAGE_PUBLISHED: The published stage."},"v1RunState":{"type":"object","properties":{"pending":{"$ref":"#/components/schemas/v1PendingRunState"},"executing":{"$ref":"#/components/schemas/v1ExecutingRunState"},"stopping":{"$ref":"#/components/schemas/v1StoppingRunState"},"stopped":{"$ref":"#/components/schemas/v1StoppedRunState"},"awaiting_guidance":{"$ref":"#/components/schemas/v1AwaitingGuidanceRunState"},"completed":{"$ref":"#/components/schemas/v1CompletedRunState"},"failed":{"$ref":"#/components/schemas/v1FailedRunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when the run transitioned to this state.","readOnly":true},"archived":{"$ref":"#/components/schemas/v1ArchivedRunState"},"awaiting_answer":{"$ref":"#/components/schemas/v1AwaitingAnswerRunState"}},"description":"RunState represents the overall lifecycle state of a run.\nTracks the run from initial submission through completion or failure."},"v1PendingRunState":{"type":"object","description":"Run has been submitted and is waiting to start execution.\nThe run is queued and will begin when resources become available."},"v1ExecutingRunState":{"type":"object","description":"Run is currently being executed.\nCode is actively running and making progress."},"v1StoppingRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run is in the process of being stopped.\nExecution is stopping gracefully and will transition to STOPPED state."},"v1StoppedRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run has been stopped and can be resumed later.\nExecution is temporarily stopped but can continue from current state."},"v1AwaitingGuidanceRunState":{"type":"object","properties":{"exception":{"type":"string","title":"ID of the exception (from guidance center)","readOnly":true},"description":{"type":"string","description":"Description of the exception that occured.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"},"rain_thread_id":{"type":"string","description":"The Rain thread ID for this exception on the Astral-on-Rain path. Each\nexception gets its own Rain thread so clients can subscribe to just this\nexception's events. Empty on the local path or when Rain is disabled.","readOnly":true}},"description":"Run is waiting for external guidance or user input.\nRequires manual intervention or external decision to proceed."},"commonV1Location":{"type":"object","properties":{"start_byte":{"type":"string","format":"int64","title":"Starting Byte of the span, It will be zero-based"},"end_byte":{"type":"string","format":"int64","title":"Ending Byte(exclusive) of the span, It will be zero-based"},"start_position":{"$ref":"#/components/schemas/v1Position"},"end_position":{"$ref":"#/components/schemas/v1Position"}},"description":"Location represents a generic span within some underlying content.\nIt specifies the starting byte offset and the ending byte offset (exclusive) of the span.\nThis can be used for pointing to regions in files, buffers, logs, messages,\nor any other byte-addressable resource."},"v1Position":{"type":"object","properties":{"line":{"type":"integer","format":"int32","description":"0-based line number."},"column":{"type":"integer","format":"int32","description":"0-based column offset (bytes from line start)."}},"description":"A position in a text document expressed as 0-based line and column."},"v1CompletedRunState":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The outputs of the run.","readOnly":true}},"description":"Run has completed successfully.\nAll code has been executed and results are available."},"v1FailedRunState":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the error that caused the run to fail.","readOnly":true},"description":{"type":"string","description":"The description of the error.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"}},"description":"Run has failed due to an error.\nExecution stopped due to an unrecoverable error condition."},"v1ArchivedRunState":{"type":"object","description":"Run has been archived by the user.\nThe run is preserved for historical reference but cannot be modified,\nresumed, or mutated in any way."},"v1AwaitingAnswerRunState":{"type":"object","properties":{"invocation_id":{"type":"string","description":"Identity of the ask() invocation the run is waiting on.","readOnly":true},"question_key":{"type":"string","description":"Author-supplied key identifying the recurring logical question.","readOnly":true},"prompt":{"type":"string","description":"The question shown to the person.","readOnly":true},"form":{"$ref":"#/components/schemas/v1FormSpec"},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Supporting values frozen with the question.","readOnly":true}},"description":"Run is intentionally waiting for a person to answer an ask() question.\nThis is planned waiting, not a failure or an exception: the run resumes once\nthe question is answered through the authoring experience or Workbench."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1AutomationStage":{"type":"string","enum":["AUTOMATION_STAGE_UNSPECIFIED","AUTOMATION_STAGE_DRAFT","AUTOMATION_STAGE_PUBLISHED"],"default":"AUTOMATION_STAGE_UNSPECIFIED","description":"AutomationStage represents the publication stage of an automation.\nThis enum is shared across services that manage or execute automations.\n\n - AUTOMATION_STAGE_UNSPECIFIED: Automation stage is not specified.\n - AUTOMATION_STAGE_DRAFT: Automation is in draft stage and can be modified.\n - AUTOMATION_STAGE_PUBLISHED: Automation is published and immutable, ready for execution."},"v1InvocationDetails":{"type":"object","properties":{"trigger_id":{"type":"string","description":"The ID of the trigger that initiated this run, if applicable."},"user_id":{"type":"string","description":"The ID of the user that initiated this run, if applicable."},"invocation_source":{"$ref":"#/components/schemas/v1InvocationSource"}},"description":"InvocationDetails contains additional information about the entity that initiated a run."},"v1InvocationSource":{"type":"string","enum":["INVOCATION_SOURCE_UNSPECIFIED","INVOCATION_SOURCE_MANUAL","INVOCATION_SOURCE_TRIGGER","INVOCATION_SOURCE_SCHEDULE","INVOCATION_SOURCE_PAT","INVOCATION_SOURCE_TEST"],"default":"INVOCATION_SOURCE_UNSPECIFIED","description":"InvocationSource identifies the entity responsible for creating a run.\n\n - INVOCATION_SOURCE_UNSPECIFIED: Unspecified invocation source.\n - INVOCATION_SOURCE_MANUAL: Run was manually initiated by a user.\n - INVOCATION_SOURCE_TRIGGER: Run was triggered by an event or trigger.\n - INVOCATION_SOURCE_SCHEDULE: Run was initiated by a schedule.\n - INVOCATION_SOURCE_PAT: Run was initiated via a Personal Access Token (PAT).\n - INVOCATION_SOURCE_TEST: Run was initiated by Quill agent for testing draft automations."},"v1RunContentCoverage":{"type":"object","properties":{"file_count":{"type":"integer","format":"int32","description":"The number of files found in the run.","readOnly":true},"indexed_file_count":{"type":"integer","format":"int32","description":"The number of files whose text is searchable.","readOnly":true},"partially_indexed_file_count":{"type":"integer","format":"int32","description":"The number of indexed files that are only partly searchable, because their\ntext was cut off at a size limit or some of their pages have no text layer.\nThese files are also counted in indexed_file_count, so this is never larger.","readOnly":true},"pending_file_count":{"type":"integer","format":"int32","description":"The number of files not indexed yet: waiting, being read, or due for a\nretry after a temporary error.","readOnly":true},"skipped_file_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1SkippedFileCount"},"description":"The files that will not be indexed, counted by reason. Holds one entry for\neach reason that applies to at least one file, in no particular order.","readOnly":true}},"description":"RunContentCoverage counts a run's files by whether the ListRuns search filter\nterm can match the text inside them.\n\nThe files counted are those in the run's inputs, outputs and trigger payload,\nthe files its steps used as recorded in the Run log, and text values offloaded\nto object storage. Text the steps produced is not a file and is not counted. A\nfile is counted once however many places it appears in, and in exactly one of\nindexed_file_count, pending_file_count and skipped_file_counts, so file_count\nis their sum. The counts cover the files found so far: a run that is still\nexecuting, or whose Run log has not been read yet, can gain files later."},"v1SkippedFileCount":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/v1ContentSkipReason"},"file_count":{"type":"integer","format":"int32","description":"The number of files skipped for this reason.","readOnly":true}},"description":"The number of a run's files that content search skipped for one reason."},"v1ContentSkipReason":{"type":"string","enum":["CONTENT_SKIP_REASON_UNSPECIFIED","CONTENT_SKIP_REASON_NO_TEXT_LAYER","CONTENT_SKIP_REASON_TOO_LARGE","CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT","CONTENT_SKIP_REASON_ENCRYPTED","CONTENT_SKIP_REASON_FAILED","CONTENT_SKIP_REASON_TOO_MANY_FILES","CONTENT_SKIP_REASON_INACCESSIBLE"],"default":"CONTENT_SKIP_REASON_UNSPECIFIED","description":"Why content search will not index one of a run's files.\nMore reasons may be added; treat a value you do not recognize as a file that\nis not searchable for an unstated reason.\n\n - CONTENT_SKIP_REASON_UNSPECIFIED: Unspecified reason. Not returned by the server.\n - CONTENT_SKIP_REASON_NO_TEXT_LAYER: The file has no text layer, such as an image or a scanned PDF. Content\nsearch does not run OCR.\n - CONTENT_SKIP_REASON_TOO_LARGE: The file is larger than content search reads. A file that is only cut off\nat a limit is indexed instead, and counted in\nRunContentCoverage.partially_indexed_file_count.\n - CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT: Content search cannot read the file's format, such as a legacy Word or\nPowerPoint document, an Outlook message, or an archive.\n - CONTENT_SKIP_REASON_ENCRYPTED: The file is password-protected.\n - CONTENT_SKIP_REASON_FAILED: Reading the file failed and will not be retried, for example because the\nfile is corrupt, or reading it kept crashing or timing out.\n - CONTENT_SKIP_REASON_TOO_MANY_FILES: The run has more files than content search indexes for a single run, and\nthis file is beyond that limit.\n - CONTENT_SKIP_REASON_INACCESSIBLE: The file cannot be read from this run: it no longer exists, or the run\nrefers to it somewhere content search does not follow, such as another\nworkspace."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"RunServiceAnswerRunBody":{"type":"object","properties":{"invocation_id":{"type":"string","description":"The current ask invocation, as returned in awaiting_answer."},"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Values keyed by the frozen form's field keys. Missing required fields and\nvalues that do not satisfy the frozen form are rejected."}},"description":"Request message for AnswerRun.","required":["invocation_id","values"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}:answer":{"post":{"summary":"Answer Run","description":"Answers the current question of a draft run or an explicit test run.\nPublished operational runs must be answered through Workbench.\nRepeating the same answer for the same invocation is idempotent; a conflicting\nanswer, stale invocation, or stopped run is rejected without resuming it.","operationId":"AnswerRun","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Run"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunServiceAnswerRunBody"}}},"required":true},"tags":["Runs"]}}}}
```

## Replay Run

> Re-executes a prior run's Main phase with updated code, returning a new run.\
> \
> ReplayRun only supports single-phase (Main) automations. The new run takes its\
> code and version from the request, and inherits the rest from the source run:\
> user\_inputs, stage, and exception-handling flags. Invocation details describe\
> the new invocation; omitted details default to TEST. Test invocations cannot\
> replay PUBLISHED runs. previous\_run is set to the source run so completed book\
> calls can be replayed from its recordings.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1Run":{"type":"object","properties":{"name":{"type":"string","title":"The name of the run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"executable_steps":{"$ref":"#/components/schemas/v1ExecutableSteps"},"create_time":{"type":"string","format":"date-time","description":"The timestamp when this run was created.\nSet automatically when the run is first submitted to the system.","readOnly":true},"state":{"$ref":"#/components/schemas/v1RunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when this run was updated.\nSet automatically when the run is updated.","readOnly":true},"previous_run":{"type":"string","title":"The name of the previous run in the chain, if applicable.\nExecution details of the previous run may be used to avoid re-computation.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"stage_version":{"type":"string","description":"The version of the automation stage at the time this run was created."},"invocation_details":{"$ref":"#/components/schemas/v1InvocationDetails"},"user_inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The user inputs provided to the run during pre phase and will be available for the UI to display the user inputs."},"root_run":{"type":"string","title":"The first run in this run's replay lineage. A run created fresh is its own\nroot; a run created by ReplayRun shares its source run's root. Lets a whole\nreplay lineage be fetched in one query (ListRuns filtered by root_run), and\ntop-level runs be listed by filtering for an empty previous_run.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}","readOnly":true},"disable_exception_handling":{"type":"boolean","description":"Whether to disable exception creation and handling when this run encounters guidance\nand enters the Awaiting Guidance state.\nApplies only to draft-stage runs. Published-stage runs always use standard Astral exception handling."},"enable_astral_on_rain":{"type":"boolean","description":"Whether exception handling should be performed by the Astral agent deployed\non the Rain agent framework."},"active_step_index":{"type":"integer","format":"int32","description":"The zero-based index of the step currently executing within executable_steps.\nAbsent when executable_steps is empty (single-step runs without a pre-phase).","readOnly":true},"archived_time":{"type":"string","format":"date-time","description":"The timestamp when this run was archived, if it has been archived.\nWhen set, the run cannot be mutated (pause, resume, skip, patch, retry).\nThe state field continues to reflect the real terminal execution state.","readOnly":true},"content_coverage":{"$ref":"#/components/schemas/v1RunContentCoverage"}},"description":"Run represents a single execution instance of code in the Jeeves platform.\nContains the executable code, metadata, and current execution state.","required":["stage","stage_version"]},"v1ExecutableSteps":{"type":"object","properties":{"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Input parameters for the execution, provided as name-value pairs.\nThese variables will be available to the code during execution."},"executables":{"type":"array","items":{"$ref":"#/components/schemas/v1ExecutableStep"},"description":"The source code to be executed, written in SPy (Simplified Python) language."}},"description":"ExecutableSteps represents a sequence of steps of execution of a run. Each step is\na separate computable unit with its own code, book connections and optional inputs.\nThe first step may optionally have an input provided to it when the run is invoked.\nThe output of each step becomes the input of the next step and the output of the\nlast step becomes the output of the run.","required":["executables"]},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1ExecutableStep":{"type":"object","properties":{"code":{"type":"string","description":"The source code to be executed, written in SPy (Simplified Python) language.\nThis is the main logic that will be interpreted and run by the execution engine."},"book_connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections required by this executable.\nMaps connection names to their specific ID and endpoints."},"phase_type":{"$ref":"#/components/schemas/v1AutomationPhaseType"},"collections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1CollectionRef"},"description":"Collections referenced by this step.\nMaps each collection slug to its reference."},"index":{"type":"integer","format":"int32","description":"Zero-based position of this step within executable_steps.","readOnly":true},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Business-tunable config for this step, keyed by config name and resolved to\nplain values. Read in SPy as kognitos.config.<name>."}},"description":"ExecutableStep represents a piece of code that can be executed in the Jeeves platform.\nContains the source code, input parameters, and external dependencies needed for execution.","required":["code","phase_type"]},"v1BookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"Unique identifier for this connection resource."},"endpoint":{"type":"string","description":"Endpoint for the connection."}},"description":"BookConnection is a resource representing a connection to a book instance.\nA connection has a unique identifier and an endpoint."},"v1AutomationPhaseType":{"type":"string","enum":["AUTOMATION_PHASE_TYPE_UNSPECIFIED","AUTOMATION_PHASE_TYPE_PRE","AUTOMATION_PHASE_TYPE_MAIN","AUTOMATION_PHASE_TYPE_POST"],"default":"AUTOMATION_PHASE_TYPE_UNSPECIFIED","description":"PhaseType defines the type of phase for an automation trigger.\n\n - AUTOMATION_PHASE_TYPE_UNSPECIFIED: Unspecified phase type.\n - AUTOMATION_PHASE_TYPE_PRE: Pre-processing phase.\n - AUTOMATION_PHASE_TYPE_MAIN: Main processing phase.\n - AUTOMATION_PHASE_TYPE_POST: Post-processing phase."},"v1CollectionRef":{"type":"object","properties":{"collection_id":{"type":"string","description":"The Bishop collection id that this slug resolves to."},"stage":{"$ref":"#/components/schemas/v1CollectionStage"}},"description":"CollectionRef references a first-class collection by the id it resolves to."},"v1CollectionStage":{"type":"string","enum":["COLLECTION_STAGE_UNSPECIFIED","COLLECTION_STAGE_DRAFT","COLLECTION_STAGE_PUBLISHED"],"default":"COLLECTION_STAGE_UNSPECIFIED","description":"CollectionStage identifies which stage of a collection a request targets.\n\n - COLLECTION_STAGE_UNSPECIFIED: Stage not specified.\n - COLLECTION_STAGE_DRAFT: The draft stage.\n - COLLECTION_STAGE_PUBLISHED: The published stage."},"v1RunState":{"type":"object","properties":{"pending":{"$ref":"#/components/schemas/v1PendingRunState"},"executing":{"$ref":"#/components/schemas/v1ExecutingRunState"},"stopping":{"$ref":"#/components/schemas/v1StoppingRunState"},"stopped":{"$ref":"#/components/schemas/v1StoppedRunState"},"awaiting_guidance":{"$ref":"#/components/schemas/v1AwaitingGuidanceRunState"},"completed":{"$ref":"#/components/schemas/v1CompletedRunState"},"failed":{"$ref":"#/components/schemas/v1FailedRunState"},"update_time":{"type":"string","format":"date-time","description":"The timestamp when the run transitioned to this state.","readOnly":true},"archived":{"$ref":"#/components/schemas/v1ArchivedRunState"},"awaiting_answer":{"$ref":"#/components/schemas/v1AwaitingAnswerRunState"}},"description":"RunState represents the overall lifecycle state of a run.\nTracks the run from initial submission through completion or failure."},"v1PendingRunState":{"type":"object","description":"Run has been submitted and is waiting to start execution.\nThe run is queued and will begin when resources become available."},"v1ExecutingRunState":{"type":"object","description":"Run is currently being executed.\nCode is actively running and making progress."},"v1StoppingRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run is in the process of being stopped.\nExecution is stopping gracefully and will transition to STOPPED state."},"v1StoppedRunState":{"type":"object","properties":{"reason":{"type":"string","description":"The reason provided by the user for stopping the run.","readOnly":true}},"description":"Run has been stopped and can be resumed later.\nExecution is temporarily stopped but can continue from current state."},"v1AwaitingGuidanceRunState":{"type":"object","properties":{"exception":{"type":"string","title":"ID of the exception (from guidance center)","readOnly":true},"description":{"type":"string","description":"Description of the exception that occured.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"},"rain_thread_id":{"type":"string","description":"The Rain thread ID for this exception on the Astral-on-Rain path. Each\nexception gets its own Rain thread so clients can subscribe to just this\nexception's events. Empty on the local path or when Rain is disabled.","readOnly":true}},"description":"Run is waiting for external guidance or user input.\nRequires manual intervention or external decision to proceed."},"commonV1Location":{"type":"object","properties":{"start_byte":{"type":"string","format":"int64","title":"Starting Byte of the span, It will be zero-based"},"end_byte":{"type":"string","format":"int64","title":"Ending Byte(exclusive) of the span, It will be zero-based"},"start_position":{"$ref":"#/components/schemas/v1Position"},"end_position":{"$ref":"#/components/schemas/v1Position"}},"description":"Location represents a generic span within some underlying content.\nIt specifies the starting byte offset and the ending byte offset (exclusive) of the span.\nThis can be used for pointing to regions in files, buffers, logs, messages,\nor any other byte-addressable resource."},"v1Position":{"type":"object","properties":{"line":{"type":"integer","format":"int32","description":"0-based line number."},"column":{"type":"integer","format":"int32","description":"0-based column offset (bytes from line start)."}},"description":"A position in a text document expressed as 0-based line and column."},"v1CompletedRunState":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"The outputs of the run.","readOnly":true}},"description":"Run has completed successfully.\nAll code has been executed and results are available."},"v1FailedRunState":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the error that caused the run to fail.","readOnly":true},"description":{"type":"string","description":"The description of the error.","readOnly":true},"location":{"$ref":"#/components/schemas/commonV1Location"}},"description":"Run has failed due to an error.\nExecution stopped due to an unrecoverable error condition."},"v1ArchivedRunState":{"type":"object","description":"Run has been archived by the user.\nThe run is preserved for historical reference but cannot be modified,\nresumed, or mutated in any way."},"v1AwaitingAnswerRunState":{"type":"object","properties":{"invocation_id":{"type":"string","description":"Identity of the ask() invocation the run is waiting on.","readOnly":true},"question_key":{"type":"string","description":"Author-supplied key identifying the recurring logical question.","readOnly":true},"prompt":{"type":"string","description":"The question shown to the person.","readOnly":true},"form":{"$ref":"#/components/schemas/v1FormSpec"},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Supporting values frozen with the question.","readOnly":true}},"description":"Run is intentionally waiting for a person to answer an ask() question.\nThis is planned waiting, not a failure or an exception: the run resumes once\nthe question is answered through the authoring experience or Workbench."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1AutomationStage":{"type":"string","enum":["AUTOMATION_STAGE_UNSPECIFIED","AUTOMATION_STAGE_DRAFT","AUTOMATION_STAGE_PUBLISHED"],"default":"AUTOMATION_STAGE_UNSPECIFIED","description":"AutomationStage represents the publication stage of an automation.\nThis enum is shared across services that manage or execute automations.\n\n - AUTOMATION_STAGE_UNSPECIFIED: Automation stage is not specified.\n - AUTOMATION_STAGE_DRAFT: Automation is in draft stage and can be modified.\n - AUTOMATION_STAGE_PUBLISHED: Automation is published and immutable, ready for execution."},"v1InvocationDetails":{"type":"object","properties":{"trigger_id":{"type":"string","description":"The ID of the trigger that initiated this run, if applicable."},"user_id":{"type":"string","description":"The ID of the user that initiated this run, if applicable."},"invocation_source":{"$ref":"#/components/schemas/v1InvocationSource"}},"description":"InvocationDetails contains additional information about the entity that initiated a run."},"v1InvocationSource":{"type":"string","enum":["INVOCATION_SOURCE_UNSPECIFIED","INVOCATION_SOURCE_MANUAL","INVOCATION_SOURCE_TRIGGER","INVOCATION_SOURCE_SCHEDULE","INVOCATION_SOURCE_PAT","INVOCATION_SOURCE_TEST"],"default":"INVOCATION_SOURCE_UNSPECIFIED","description":"InvocationSource identifies the entity responsible for creating a run.\n\n - INVOCATION_SOURCE_UNSPECIFIED: Unspecified invocation source.\n - INVOCATION_SOURCE_MANUAL: Run was manually initiated by a user.\n - INVOCATION_SOURCE_TRIGGER: Run was triggered by an event or trigger.\n - INVOCATION_SOURCE_SCHEDULE: Run was initiated by a schedule.\n - INVOCATION_SOURCE_PAT: Run was initiated via a Personal Access Token (PAT).\n - INVOCATION_SOURCE_TEST: Run was initiated by Quill agent for testing draft automations."},"v1RunContentCoverage":{"type":"object","properties":{"file_count":{"type":"integer","format":"int32","description":"The number of files found in the run.","readOnly":true},"indexed_file_count":{"type":"integer","format":"int32","description":"The number of files whose text is searchable.","readOnly":true},"partially_indexed_file_count":{"type":"integer","format":"int32","description":"The number of indexed files that are only partly searchable, because their\ntext was cut off at a size limit or some of their pages have no text layer.\nThese files are also counted in indexed_file_count, so this is never larger.","readOnly":true},"pending_file_count":{"type":"integer","format":"int32","description":"The number of files not indexed yet: waiting, being read, or due for a\nretry after a temporary error.","readOnly":true},"skipped_file_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1SkippedFileCount"},"description":"The files that will not be indexed, counted by reason. Holds one entry for\neach reason that applies to at least one file, in no particular order.","readOnly":true}},"description":"RunContentCoverage counts a run's files by whether the ListRuns search filter\nterm can match the text inside them.\n\nThe files counted are those in the run's inputs, outputs and trigger payload,\nthe files its steps used as recorded in the Run log, and text values offloaded\nto object storage. Text the steps produced is not a file and is not counted. A\nfile is counted once however many places it appears in, and in exactly one of\nindexed_file_count, pending_file_count and skipped_file_counts, so file_count\nis their sum. The counts cover the files found so far: a run that is still\nexecuting, or whose Run log has not been read yet, can gain files later."},"v1SkippedFileCount":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/v1ContentSkipReason"},"file_count":{"type":"integer","format":"int32","description":"The number of files skipped for this reason.","readOnly":true}},"description":"The number of a run's files that content search skipped for one reason."},"v1ContentSkipReason":{"type":"string","enum":["CONTENT_SKIP_REASON_UNSPECIFIED","CONTENT_SKIP_REASON_NO_TEXT_LAYER","CONTENT_SKIP_REASON_TOO_LARGE","CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT","CONTENT_SKIP_REASON_ENCRYPTED","CONTENT_SKIP_REASON_FAILED","CONTENT_SKIP_REASON_TOO_MANY_FILES","CONTENT_SKIP_REASON_INACCESSIBLE"],"default":"CONTENT_SKIP_REASON_UNSPECIFIED","description":"Why content search will not index one of a run's files.\nMore reasons may be added; treat a value you do not recognize as a file that\nis not searchable for an unstated reason.\n\n - CONTENT_SKIP_REASON_UNSPECIFIED: Unspecified reason. Not returned by the server.\n - CONTENT_SKIP_REASON_NO_TEXT_LAYER: The file has no text layer, such as an image or a scanned PDF. Content\nsearch does not run OCR.\n - CONTENT_SKIP_REASON_TOO_LARGE: The file is larger than content search reads. A file that is only cut off\nat a limit is indexed instead, and counted in\nRunContentCoverage.partially_indexed_file_count.\n - CONTENT_SKIP_REASON_UNSUPPORTED_FORMAT: Content search cannot read the file's format, such as a legacy Word or\nPowerPoint document, an Outlook message, or an archive.\n - CONTENT_SKIP_REASON_ENCRYPTED: The file is password-protected.\n - CONTENT_SKIP_REASON_FAILED: Reading the file failed and will not be retried, for example because the\nfile is corrupt, or reading it kept crashing or timing out.\n - CONTENT_SKIP_REASON_TOO_MANY_FILES: The run has more files than content search indexes for a single run, and\nthis file is beyond that limit.\n - CONTENT_SKIP_REASON_INACCESSIBLE: The file cannot be read from this run: it no longer exists, or the run\nrefers to it somewhere content search does not follow, such as another\nworkspace."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"RunServiceReplayRunBody":{"type":"object","properties":{"executable_step":{"$ref":"#/components/schemas/v1ExecutableStep"},"stage_version":{"type":"string","description":"The automation stage version the updated code was saved at."},"invocation_details":{"$ref":"#/components/schemas/v1InvocationDetails"}},"description":"Request message for ReplayRun method.","required":["executable_step","stage_version"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}:replay":{"post":{"summary":"Replay Run","description":"Re-executes a prior run's Main phase with updated code, returning a new run.\n\nReplayRun only supports single-phase (Main) automations. The new run takes its\ncode and version from the request, and inherits the rest from the source run:\nuser_inputs, stage, and exception-handling flags. Invocation details describe\nthe new invocation; omitted details default to TEST. Test invocations cannot\nreplay PUBLISHED runs. previous_run is set to the source run so completed book\ncalls can be replayed from its recordings.","operationId":"ReplayRun","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Run"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunServiceReplayRunBody"}}},"required":true},"tags":["Runs"]}}}}
```

## Archive Runs

> Archives a list of runs by their unique identifiers.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1ArchiveRunsResponse":{"type":"object","description":"Response message for ArchiveRuns method."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"RunServiceArchiveRunsBody":{"type":"object","properties":{"names":{"type":"array","items":{"type":"string"},"title":"The unique identifiers of the runs to archive.\nFormat: organizations/{organization}/workspaces/{workspace}/automations/{automation}/runs/{run}"}},"description":"Request message for ArchiveRuns method.\nSpecifies which runs to archive by their unique identifiers.","required":["names"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs:archive":{"post":{"summary":"Archive Runs","description":"Archives a list of runs by their unique identifiers.","operationId":"ArchiveRuns","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1ArchiveRunsResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"automation_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunServiceArchiveRunsBody"}}},"required":true},"tags":["Runs"]}}}}
```

## Run Code

> RunCode executes the provided SPy code and returns the execution status.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1RunCodeResponse":{"type":"object","properties":{"execution_status":{"$ref":"#/components/schemas/v1ExecutionStatus"}},"description":"RunCodeResponse contains the execution status.","required":["execution_status"]},"v1ExecutionStatus":{"type":"object","properties":{"execution_id":{"type":"string","title":"Unique identifier for the execution"},"update_time":{"type":"string","format":"date-time","title":"When this status update was generated"},"started":{"$ref":"#/components/schemas/jarvisexecution_statusv1ExecutionStarted"},"in_progress":{"$ref":"#/components/schemas/v1ExecutionInProgress"},"completed":{"$ref":"#/components/schemas/jarvisexecution_statusv1ExecutionCompleted"},"stopped":{"$ref":"#/components/schemas/jarvisexecution_statusv1ExecutionStopped"},"failed":{"$ref":"#/components/schemas/jarvisexecution_statusv1ExecutionFailed"}},"description":"ExecutionStatus represents the current state of a Jarvis code execution.\nThis message is sent periodically to provide updates on execution progress,\ncompletion, or failure conditions. Each status update includes a timestamp\nand the specific status information."},"jarvisexecution_statusv1ExecutionStarted":{"type":"object","description":"ExecutionStarted indicates that Jarvis has started the execution."},"v1ExecutionInProgress":{"type":"object","description":"ExecutionInProgress indicates that Jarvis is still running the execution.\nThis status acts as a heartbeat to confirm that the execution is still running."},"jarvisexecution_statusv1ExecutionCompleted":{"type":"object","properties":{"outputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Map of named output values set by the set_output() builtin function during execution.\nEach entry is a name-value pair where the key is the output name (string) and\nthe value is the output value set by calling set_output(name, value).\nThis map will be empty if no set_output() calls were made during execution."},"return_value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"ExecutionCompleted indicates that Jarvis has successfully completed the execution."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"jarvisexecution_statusv1ExecutionStopped":{"type":"object","properties":{"user_stopped":{"$ref":"#/components/schemas/jarvisexecution_statusv1UserStopped"},"waiting_on_book":{"$ref":"#/components/schemas/jarvisexecution_statusv1WaitingOnBook"},"waiting_on_timer":{"$ref":"#/components/schemas/jarvisexecution_statusv1WaitingOnTimer"},"program_stopped":{"$ref":"#/components/schemas/jarvisexecution_statusv1ProgramStopped"},"waiting_on_book_connection":{"$ref":"#/components/schemas/jarvisexecution_statusv1WaitingOnBookConnection"}},"description":"ExecutionStopped indicates that the execution was stopped before completion due to\na specific reason."},"jarvisexecution_statusv1UserStopped":{"type":"object","description":"UserStopped indicates that the execution was stopped by a user."},"jarvisexecution_statusv1WaitingOnBook":{"type":"object","description":"WaitingOnBook indicates that the execution is stopped because its\nwaiting on an async book procedure to complete. The run manager is expected\nto resume the execution when the book procedure completes."},"jarvisexecution_statusv1WaitingOnTimer":{"type":"object","properties":{"duration":{"type":"string","description":"The duration of the timer."}},"description":"WaitingOnTimer indicates that the execution is stopped because its\nwaiting for a timer to fire. The run manager is expected to resume the\nexecution when the timer fires."},"jarvisexecution_statusv1ProgramStopped":{"type":"object","properties":{"reason":{"type":"string","description":"The reason the program was stopped."}},"description":"ProgramStopped indicates that the execution was stopped by the program."},"jarvisexecution_statusv1WaitingOnBookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"The book connection that is not ready."},"book_name":{"type":"string","description":"The name of the book the connection is for."},"state":{"type":"string","description":"The state of the book connection when the execution stopped."}},"description":"WaitingOnBookConnection indicates that the execution is stopped because a book connection\nit calls is not ready. The run manager resumes the execution once the connection is ready."},"jarvisexecution_statusv1ExecutionFailed":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/v1ExecutionError"}},"description":"ExecutionFailed indicates that the execution encountered an error and\ncould not complete successfully."},"v1ExecutionError":{"type":"object","properties":{"id":{"type":"string","title":"Unique identifier for the error"},"description":{"type":"string","title":"Human-readable description of what went wrong"},"context":{"$ref":"#/components/schemas/v1Context"},"extra":{"type":"object","additionalProperties":{"type":"string"},"title":"Extra information about the error"},"code":{"type":"string","title":"The code where the error was raised (includes patches)\nIf the error was raised in a patch, the code reflects the patched code\nand the error location is relative to the patched code instead of the original\ncode\nNote: this field does not include previous patches that executed successfully"},"typed_extra":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"title":"Extra information about the error, as typed values that may be offloaded"}},"description":"ExecutionError represents an error that occurred during execution."},"v1Context":{"type":"object","properties":{"code_location":{"$ref":"#/components/schemas/commonV1Location"},"node_id":{"type":"string","title":"The id of node"},"connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"description":"Book connections active at the time of failure (connection name → connection details).\nAllows consumers to know which connections were available when the error occurred,\nwhich is useful for re-submitting a resume with the correct connection IDs."},"runtime_values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Runtime values of the variables used by the sentence that failed\n(variable name → value)."},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonV1Value"},"description":"Read-only config values active at the time of failure (config name → value).\nMirrors `connections`: lets consumers see the config the SPy code read via\nkognitos.config.<name> when re-submitting a resume."}},"description":"Context provides additional information about the execution environment,\nsuch as stack traces for debugging purposes."},"commonV1Location":{"type":"object","properties":{"start_byte":{"type":"string","format":"int64","title":"Starting Byte of the span, It will be zero-based"},"end_byte":{"type":"string","format":"int64","title":"Ending Byte(exclusive) of the span, It will be zero-based"},"start_position":{"$ref":"#/components/schemas/v1Position"},"end_position":{"$ref":"#/components/schemas/v1Position"}},"description":"Location represents a generic span within some underlying content.\nIt specifies the starting byte offset and the ending byte offset (exclusive) of the span.\nThis can be used for pointing to regions in files, buffers, logs, messages,\nor any other byte-addressable resource."},"v1Position":{"type":"object","properties":{"line":{"type":"integer","format":"int32","description":"0-based line number."},"column":{"type":"integer","format":"int32","description":"0-based column offset (bytes from line start)."}},"description":"A position in a text document expressed as 0-based line and column."},"v1BookConnection":{"type":"object","properties":{"connection_id":{"type":"string","description":"Unique identifier for this connection resource."},"endpoint":{"type":"string","description":"Endpoint for the connection."}},"description":"BookConnection is a resource representing a connection to a book instance.\nA connection has a unique identifier and an endpoint."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"JarvisServiceRunCodeBody":{"type":"object","properties":{"start_execution":{"type":"object","properties":{"run_id":{"type":"string","title":"Optional: Run identifier"},"code":{"type":"string","title":"The SPy code to execute"},"inputs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"title":"Input variables available to the code during execution"},"connections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1BookConnection"},"title":"External book connections required by the code\nThe key is the name of the connection used in the SPy code\nThe value contains the connection details"},"record_execution_id":{"type":"string","description":"Optional execution_id of the recorded execution to be used for replaying\nBDK procedure calls (that have side-effects).\nDEPRECATED: Use record_mode.replay_record.execution_id instead."},"phase_execution_id":{"type":"string","description":"Optional execution_id of a previous execution to inherit memory state from.\nWhen specified, the execution will start fresh but with memory variables\nloaded from the checkpoint of the specified execution_id."},"automation_id":{"type":"string","title":"Optional id of the automation which the execution is part of"},"automation_phase_id":{"type":"string","title":"Optional id of the automation phase which the execution is part of"},"no_recording":{"$ref":"#/components/schemas/v1NoRecording"},"record_only":{"$ref":"#/components/schemas/v1RecordOnly"},"replay_record":{"$ref":"#/components/schemas/v1ReplayRecord"},"replay_only":{"$ref":"#/components/schemas/v1ReplayOnly"},"stage":{"$ref":"#/components/schemas/v1AutomationStage"},"extra_metadata":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Optional extra metadata to be stored with the execution\nThis will be used to pass the additional information that downstream services might require\nbut there is no need to Jarvis to know about it."},"entry_point":{"type":"string","description":"The name of the SPy function to invoke as the entry point.\nWhen set, Jarvis executes this function instead of the default \"main\",\nmapping the provided inputs to the function's parameters.\nDefaults to \"main\" when not specified."},"collections":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1CollectionRef"},"description":"First-class collections referenced by the SPy code, delivered as a\nslug -> CollectionRef map.\nThe key is the collection slug used in `kognitos.collection.<slug>.<method>(...)`;\nthe value carries the Bishop collection id that Jarvis resolves at call time.\nJarvis never mints slugs or ids -- it only resolves them."},"config":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"First-class config values read by the SPy code via kognitos.config.<name>.\nThe key is the config name; the value carries the resolved read-only value.\nConfig is read-only during execution -- these values are resolved at start\nand never written back."}},"title":"The start execution command"}},"title":"Request body to run the Spy Code","required":["start_execution"]},"v1NoRecording":{"type":"object","description":"Mode: NoRecording\nStarts a fresh execution without recording side-effects."},"v1RecordOnly":{"type":"object","description":"Mode: RecordOnly\nStarts a fresh execution and records side-effects (Book calls)."},"v1ReplayRecord":{"type":"object","properties":{"execution_id":{"type":"string","description":"The ID of the execution to replay from."}},"description":"Mode: ReplayRecord\nReplays side-effects from a previous execution and records any new interactions."},"v1ReplayOnly":{"type":"object","properties":{"execution_id":{"type":"string","description":"The ID of the execution to replay from."}},"description":"Mode: ReplayOnly\nReplays side-effects from a previous execution without recording any\nnew interactions. Useful for deterministic re-runs and debugging where\nthe recording should not be mutated or extended."},"v1AutomationStage":{"type":"string","enum":["AUTOMATION_STAGE_UNSPECIFIED","AUTOMATION_STAGE_DRAFT","AUTOMATION_STAGE_PUBLISHED"],"default":"AUTOMATION_STAGE_UNSPECIFIED","description":"AutomationStage represents the publication stage of an automation.\nThis enum is shared across services that manage or execute automations.\n\n - AUTOMATION_STAGE_UNSPECIFIED: Automation stage is not specified.\n - AUTOMATION_STAGE_DRAFT: Automation is in draft stage and can be modified.\n - AUTOMATION_STAGE_PUBLISHED: Automation is published and immutable, ready for execution."},"v1CollectionRef":{"type":"object","properties":{"collection_id":{"type":"string","description":"The Bishop collection id that this slug resolves to."},"stage":{"$ref":"#/components/schemas/v1CollectionStage"}},"description":"CollectionRef references a first-class collection by the id it resolves to."},"v1CollectionStage":{"type":"string","enum":["COLLECTION_STAGE_UNSPECIFIED","COLLECTION_STAGE_DRAFT","COLLECTION_STAGE_PUBLISHED"],"default":"COLLECTION_STAGE_UNSPECIFIED","description":"CollectionStage identifies which stage of a collection a request targets.\n\n - COLLECTION_STAGE_UNSPECIFIED: Stage not specified.\n - COLLECTION_STAGE_DRAFT: The draft stage.\n - COLLECTION_STAGE_PUBLISHED: The published stage."}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/executions:run":{"post":{"summary":"Run Code","description":"RunCode executes the provided SPy code and returns the execution status.","operationId":"RunCode","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1RunCodeResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","description":"The organization id for which the execution is requested","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","description":"The workspace id for which the execution is requested","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JarvisServiceRunCodeBody"}}},"required":true},"tags":["Runs"]}}}}
```

## Batch Get Run Execution Times

> Compute the net execution time for multiple automation runs.\
> \
> For each run, this RPC reads all state-transition events from InfluxDB\
> and computes:\
> &#x20; execution\_duration = total\_duration - exception\_duration\
> \
> where exception\_duration is the cumulative time the run spent in the\
> AwaitingGuidance state (waiting for exception resolution) across all\
> exception cycles. All runs must belong to the same workspace.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Runs","description":"Execute automations and manage run lifecycle — start, pause, continue, and view events."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1BatchGetRunExecutionTimesResponse":{"type":"object","properties":{"run_execution_times":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/v1RunExecutionTime"},"description":"Map from run resource name to its computed execution time.\n\nKey: run resource name (same format as BatchGetRunExecutionTimesRequest.names).\nValue: computed execution time breakdown for that run."}},"description":"Response message for the BatchGetRunExecutionTimes RPC.\n\nContains the computed execution time for each requested run, keyed by run\nresource name. All run names specified in BatchGetRunExecutionTimesRequest.names\nwill be present as keys in run_execution_times."},"v1RunExecutionTime":{"type":"object","properties":{"total_duration":{"type":"string","description":"Total wall-clock duration of the run.\n\nMeasured from the first recorded state transition to the last.","readOnly":true},"exception_duration":{"type":"string","description":"Total time the run spent waiting for exception resolution.\n\nSum of all intervals spent in the AwaitingGuidance state across all\nexception cycles during the run.","readOnly":true},"execution_duration":{"type":"string","description":"Net execution time: total_duration minus exception_duration.\n\nThis is the time the run was actively executing, excluding exception waits.","readOnly":true}},"description":"Computed execution time for a single automation run.\n\nExecution time is the net time the run was actively executing, excluding\nany time spent waiting for exception resolution (AwaitingGuidance state).\nA run may cycle through the AwaitingGuidance state multiple times; all\nsuch intervals are summed and subtracted from the total duration."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/runs/executionTimes:batchGet":{"get":{"summary":"Batch Get Run Execution Times","description":"Compute the net execution time for multiple automation runs.\n\nFor each run, this RPC reads all state-transition events from InfluxDB\nand computes:\n  execution_duration = total_duration - exception_duration\n\nwhere exception_duration is the cumulative time the run spent in the\nAwaitingGuidance state (waiting for exception resolution) across all\nexception cycles. All runs must belong to the same workspace.","operationId":"BatchGetRunExecutionTimes","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1BatchGetRunExecutionTimesResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"names","description":"The names of the runs to compute execution time for.\n\nFormat: organizations/{org}/workspaces/{workspace}/automations/{automation}/runs/{run}\nA maximum of 50 runs can be retrieved in a batch.\nAll names must have the same workspace parent as the `parent` field.","in":"query","required":true,"explode":true,"schema":{"type":"array","items":{"type":"string"}}}],"tags":["Runs"]}}}}
```
