runtype 0.2.2 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +17 -1
  3. data/README.md +104 -17
  4. data/generated/lib/runtype/agent_aliases/client.rb +49 -1
  5. data/generated/lib/runtype/agent_aliases/types/get_v1agent_aliases_request.rb +13 -0
  6. data/generated/lib/runtype/agent_aliases/types/get_v1agent_aliases_response.rb +11 -0
  7. data/generated/lib/runtype/agent_aliases/types/get_v1agent_aliases_response_data_item.rb +25 -0
  8. data/generated/lib/runtype/agent_aliases/types/post_v1agents_id_aliases_alias_rollback_response.rb +4 -0
  9. data/generated/lib/runtype/agent_aliases/types/put_v1agents_id_aliases_alias_request.rb +2 -0
  10. data/generated/lib/runtype/agent_aliases/types/put_v1agents_id_aliases_alias_response.rb +4 -0
  11. data/generated/lib/runtype/agents/types/post_v1agents_ensure_request_definition_config_memory.rb +2 -0
  12. data/generated/lib/runtype/agents/types/post_v1agents_ensure_request_definition_config_memory_pointer_scope.rb +15 -0
  13. data/generated/lib/runtype/agents/types/post_v1agents_id_execute_request_x_runtype_concurrency.rb +1 -0
  14. data/generated/lib/runtype/agents/types/post_v1agents_request_config_memory.rb +2 -0
  15. data/generated/lib/runtype/agents/types/post_v1agents_request_config_memory_pointer_scope.rb +15 -0
  16. data/generated/lib/runtype/agents/types/put_v1agents_id_request_config_memory.rb +2 -0
  17. data/generated/lib/runtype/agents/types/put_v1agents_id_request_config_memory_pointer_scope.rb +15 -0
  18. data/generated/lib/runtype/batch/types/get_v1batch_batch_id_records_record_id_steps_response_data_item_execution_engine.rb +1 -0
  19. data/generated/lib/runtype/client.rb +5 -5
  20. data/generated/lib/runtype/client_runtime/client.rb +118 -1
  21. data/generated/lib/runtype/client_runtime/types/get_v1client_conversations_conversation_id_executions_execution_id_deliveries_delivery_id_request.rb +21 -0
  22. data/generated/lib/runtype/client_runtime/types/post_v1client_chat_request_submit_mode.rb +1 -0
  23. data/generated/lib/runtype/client_runtime/types/post_v1client_conversations_conversation_id_executions_execution_id_cancel_request.rb +19 -0
  24. data/generated/lib/runtype/client_runtime/types/post_v1client_conversations_conversation_id_executions_execution_id_cancel_response.rb +13 -0
  25. data/generated/lib/runtype/client_runtime/types/post_v1client_init_response_durable_recovery.rb +2 -0
  26. data/generated/lib/runtype/client_tokens/types/get_v1client_tokens_id_response_client_token.rb +4 -0
  27. data/generated/lib/runtype/client_tokens/types/get_v1client_tokens_response_client_tokens_item.rb +4 -0
  28. data/generated/lib/runtype/client_tokens/types/post_v1client_tokens_id_regenerate_response_client_token.rb +4 -0
  29. data/generated/lib/runtype/client_tokens/types/post_v1client_tokens_request.rb +4 -0
  30. data/generated/lib/runtype/client_tokens/types/post_v1client_tokens_response_client_token.rb +4 -0
  31. data/generated/lib/runtype/client_tokens/types/put_v1client_tokens_id_request.rb +4 -0
  32. data/generated/lib/runtype/client_tokens/types/put_v1client_tokens_id_response_client_token.rb +4 -0
  33. data/generated/lib/runtype/dispatch/client.rb +5 -3
  34. data/generated/lib/runtype/dispatch/types/post_v1dispatch_request_one_agent_memory.rb +2 -0
  35. data/generated/lib/runtype/dispatch/types/post_v1dispatch_request_one_agent_memory_pointer_scope.rb +15 -0
  36. data/generated/lib/runtype/dispatch/types/post_v1dispatch_request_zero_agent_memory.rb +2 -0
  37. data/generated/lib/runtype/dispatch/types/post_v1dispatch_request_zero_agent_memory_pointer_scope.rb +15 -0
  38. data/generated/lib/runtype/evals/types/get_v1eval_id_results_response.rb +10 -0
  39. data/generated/lib/runtype/evals/types/get_v1eval_id_results_response_agent_target_resolution.rb +15 -0
  40. data/generated/lib/runtype/evals/types/get_v1eval_id_results_response_results_by_record_value_item_execution_engine.rb +1 -0
  41. data/generated/lib/runtype/evals/types/post_v1eval_run_request.rb +2 -0
  42. data/generated/lib/runtype/evals/types/post_v1eval_run_request_agent.rb +15 -0
  43. data/generated/lib/runtype/evals/types/post_v1eval_submit_request.rb +2 -0
  44. data/generated/lib/runtype/evals/types/post_v1eval_submit_request_agent.rb +15 -0
  45. data/generated/lib/runtype/evals/types/post_v1eval_suites_id_run_request.rb +2 -0
  46. data/generated/lib/runtype/executions/client.rb +43 -0
  47. data/generated/lib/runtype/executions/types/get_v1executions_execution_id_deliveries_delivery_id_request.rb +13 -0
  48. data/generated/lib/runtype/flows/client.rb +3 -4
  49. data/generated/lib/runtype/flows/types/get_v1flows_id_step_results_response_data_item_execution_engine.rb +1 -0
  50. data/generated/lib/runtype/messaging_conversations/client.rb +2 -0
  51. data/generated/lib/runtype/messaging_conversations/types/get_v1messaging_conversations_request.rb +2 -0
  52. data/generated/lib/runtype/records/types/get_v1records_id_results_response_data_item_execution_engine.rb +1 -0
  53. data/generated/lib/runtype/records/types/get_v1records_id_step_results_response_data_item_execution_engine.rb +1 -0
  54. data/generated/lib/runtype/schedules/types/get_v1schedules_batch_batch_id_results_response_data_item_execution_engine.rb +1 -0
  55. data/generated/lib/runtype/schedules/types/get_v1schedules_runs_run_id_results_response_data_item_execution_engine.rb +1 -0
  56. data/generated/lib/runtype/types/agent_deployment_promotion.rb +17 -0
  57. data/generated/lib/runtype/types/agent_ensure_preview_alias_limit.rb +19 -0
  58. data/generated/lib/runtype/types/agent_ensure_preview_alias_limit_code.rb +11 -0
  59. data/generated/lib/runtype/types/agent_ensure_preview_alias_limit_scope.rb +12 -0
  60. data/generated/lib/runtype/types/agent_pull_response_definition_config_memory.rb +2 -0
  61. data/generated/lib/runtype/types/agent_pull_response_definition_config_memory_pointer_scope.rb +13 -0
  62. data/generated/lib/runtype/types/async_dispatch_handle.rb +10 -0
  63. data/generated/lib/runtype/types/async_dispatch_handle_delivery_status.rb +14 -0
  64. data/generated/lib/runtype/types/async_dispatch_handle_status.rb +5 -0
  65. data/generated/lib/runtype/types/client_input_delivery_receipt.rb +19 -0
  66. data/generated/lib/runtype/types/client_input_delivery_receipt_status.rb +14 -0
  67. data/generated/lib/runtype/types/conversation_busy_error.rb +15 -0
  68. data/generated/lib/runtype/types/conversation_busy_error_code.rb +11 -0
  69. data/generated/lib/runtype/types/conversation_busy_error_phase.rb +14 -0
  70. data/generated/lib/runtype/types/dispatch_agent_json_response.rb +12 -0
  71. data/generated/lib/runtype/types/dispatch_agent_json_response_delivery_status.rb +14 -0
  72. data/generated/lib/runtype/types/dispatch_agent_json_response_execution_mode.rb +1 -0
  73. data/generated/lib/runtype/types/eval_agent_selector.rb +13 -0
  74. data/generated/lib/runtype/types/eval_run_scores_response.rb +10 -0
  75. data/generated/lib/runtype/types/eval_run_scores_response_agent_target_resolution.rb +13 -0
  76. data/generated/lib/runtype/types/eval_run_scores_response_cases_item_execution_engine.rb +1 -0
  77. data/generated/lib/runtype/types/eval_suite_run_queued.rb +10 -0
  78. data/generated/lib/runtype/types/eval_suite_run_queued_agent_target_resolution.rb +13 -0
  79. data/generated/lib/runtype/types/input_delivery_receipt.rb +19 -0
  80. data/generated/lib/runtype/types/input_delivery_receipt_status.rb +14 -0
  81. data/generated/lib/runtype/types/preview_alias_limit_error.rb +21 -0
  82. data/generated/lib/runtype/types/preview_alias_limit_error_code.rb +11 -0
  83. data/generated/lib/runtype/types/preview_alias_limit_error_scope.rb +12 -0
  84. data/generated/lib/runtype/types/run_eval_response.rb +10 -0
  85. data/generated/lib/runtype/types/run_eval_response_agent_target_resolution.rb +13 -0
  86. data/generated/lib/runtype.rb +52 -16
  87. data/lib/runtype/agent_ensure.rb +35 -3
  88. data/lib/runtype/agent_release_aliases.rb +138 -0
  89. data/lib/runtype/client.rb +1 -0
  90. data/lib/runtype/sdk_version.rb +1 -1
  91. data/lib/runtype.rb +1 -0
  92. metadata +38 -1
@@ -0,0 +1,13 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module ClientRuntime
5
+ module Types
6
+ class PostV1ClientConversationsConversationIDExecutionsExecutionIDCancelResponse < Internal::Types::Model
7
+ field :accepted, -> { Internal::Types::Boolean }, optional: false, nullable: false
8
+
9
+ field :execution_id, -> { String }, optional: false, nullable: false, api_name: "executionId"
10
+ end
11
+ end
12
+ end
13
+ end
@@ -7,6 +7,8 @@ module Runtype
7
7
  # streaming behavior.
8
8
  class PostV1ClientInitResponseDurableRecovery < Internal::Types::Model
9
9
  field :enabled, -> { Internal::Types::Boolean }, optional: false, nullable: false
10
+
11
+ field :join, -> { Internal::Types::Boolean }, optional: true, nullable: false
10
12
  end
11
13
  end
12
14
  end
@@ -40,6 +40,10 @@ module Runtype
40
40
 
41
41
  field :session_idle_timeout_minutes, -> { Integer }, optional: false, nullable: true, api_name: "sessionIdleTimeoutMinutes"
42
42
 
43
+ field :target_alias, -> { String }, optional: false, nullable: true, api_name: "targetAlias"
44
+
45
+ field :target_version_id, -> { String }, optional: false, nullable: true, api_name: "targetVersionId"
46
+
43
47
  field :token_hint, -> { String }, optional: false, nullable: true, api_name: "tokenHint"
44
48
 
45
49
  field :token_prefix, -> { String }, optional: false, nullable: false, api_name: "tokenPrefix"
@@ -40,6 +40,10 @@ module Runtype
40
40
 
41
41
  field :session_idle_timeout_minutes, -> { Integer }, optional: false, nullable: true, api_name: "sessionIdleTimeoutMinutes"
42
42
 
43
+ field :target_alias, -> { String }, optional: false, nullable: true, api_name: "targetAlias"
44
+
45
+ field :target_version_id, -> { String }, optional: false, nullable: true, api_name: "targetVersionId"
46
+
43
47
  field :token_hint, -> { String }, optional: false, nullable: true, api_name: "tokenHint"
44
48
 
45
49
  field :token_prefix, -> { String }, optional: false, nullable: false, api_name: "tokenPrefix"
@@ -24,6 +24,10 @@ module Runtype
24
24
 
25
25
  field :pin_to_version, -> { String }, optional: false, nullable: true, api_name: "pinToVersion"
26
26
 
27
+ field :target_alias, -> { String }, optional: false, nullable: true, api_name: "targetAlias"
28
+
29
+ field :target_version_id, -> { String }, optional: false, nullable: true, api_name: "targetVersionId"
30
+
27
31
  field :token_hint, -> { String }, optional: false, nullable: true, api_name: "tokenHint"
28
32
 
29
33
  field :token_prefix, -> { String }, optional: false, nullable: false, api_name: "tokenPrefix"
@@ -29,6 +29,10 @@ module Runtype
29
29
  field :rate_limit_per_minute, -> { Integer }, optional: true, nullable: false, api_name: "rateLimitPerMinute"
30
30
 
31
31
  field :session_idle_timeout_minutes, -> { Integer }, optional: true, nullable: false, api_name: "sessionIdleTimeoutMinutes"
32
+
33
+ field :target_alias, -> { String }, optional: true, nullable: false, api_name: "targetAlias"
34
+
35
+ field :target_version_id, -> { String }, optional: true, nullable: false, api_name: "targetVersionId"
32
36
  end
33
37
  end
34
38
  end
@@ -40,6 +40,10 @@ module Runtype
40
40
 
41
41
  field :session_idle_timeout_minutes, -> { Integer }, optional: false, nullable: true, api_name: "sessionIdleTimeoutMinutes"
42
42
 
43
+ field :target_alias, -> { String }, optional: false, nullable: true, api_name: "targetAlias"
44
+
45
+ field :target_version_id, -> { String }, optional: false, nullable: true, api_name: "targetVersionId"
46
+
43
47
  field :token_hint, -> { String }, optional: false, nullable: true, api_name: "tokenHint"
44
48
 
45
49
  field :token_prefix, -> { String }, optional: false, nullable: false, api_name: "tokenPrefix"
@@ -29,6 +29,10 @@ module Runtype
29
29
  field :rate_limit_per_minute, -> { Integer }, optional: true, nullable: false, api_name: "rateLimitPerMinute"
30
30
 
31
31
  field :session_idle_timeout_minutes, -> { Integer }, optional: true, nullable: false, api_name: "sessionIdleTimeoutMinutes"
32
+
33
+ field :target_alias, -> { String }, optional: true, nullable: false, api_name: "targetAlias"
34
+
35
+ field :target_version_id, -> { String }, optional: true, nullable: false, api_name: "targetVersionId"
32
36
  end
33
37
  end
34
38
  end
@@ -40,6 +40,10 @@ module Runtype
40
40
 
41
41
  field :session_idle_timeout_minutes, -> { Integer }, optional: false, nullable: true, api_name: "sessionIdleTimeoutMinutes"
42
42
 
43
+ field :target_alias, -> { String }, optional: false, nullable: true, api_name: "targetAlias"
44
+
45
+ field :target_version_id, -> { String }, optional: false, nullable: true, api_name: "targetVersionId"
46
+
43
47
  field :token_hint, -> { String }, optional: false, nullable: true, api_name: "tokenHint"
44
48
 
45
49
  field :token_prefix, -> { String }, optional: false, nullable: false, api_name: "tokenPrefix"
@@ -13,9 +13,11 @@ module Runtype
13
13
  # Main dispatch endpoint for flow and agent execution with record resolution. Supports streaming via SSE or
14
14
  # synchronous JSON responses. Send the RFC 7240 `Prefer: respond-async` header to receive a durable execution
15
15
  # handle immediately, then poll its status URL for completion. A saved agent may run on the durable session lane;
16
- # the admission headers `x-runtype-concurrency` (reject, supersede, queue), `x-runtype-coalesce` (true) and
17
- # `idempotency-key` then apply exactly as on `POST /v1/agents/{id}/execute`, and are ignored for a turn that
18
- # resolves to the in-process lane.
16
+ # the admission headers `x-runtype-concurrency` (reject, supersede, queue, join), `x-runtype-coalesce` (true) and
17
+ # `idempotency-key` then apply exactly as on `POST /v1/agents/{id}/execute`, and are ignored for in-process
18
+ # execution except join, which fails explicitly on unsupported lanes. Join accepts only new user-message deltas,
19
+ # preserves the active execution configuration and authority, and returns a deliveryId with a deliveryStatusUrl.
20
+ # Prefer: respond-async with join returns a native delivery receipt without queuing an HTTP replay.
19
21
  #
20
22
  # @param request_options [Hash]
21
23
  # @param params [Runtype::Dispatch::Types::PostV1DispatchRequest]
@@ -8,6 +8,8 @@ module Runtype
8
8
 
9
9
  field :inject_summary, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "injectSummary"
10
10
 
11
+ field :pointer_scope, -> { Runtype::Dispatch::Types::PostV1DispatchRequestOneAgentMemoryPointerScope }, optional: true, nullable: false, api_name: "pointerScope"
12
+
11
13
  field :profile_template, -> { String }, optional: true, nullable: false, api_name: "profileTemplate"
12
14
  end
13
15
  end
@@ -0,0 +1,15 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Dispatch
5
+ module Types
6
+ module PostV1DispatchRequestOneAgentMemoryPointerScope
7
+ extend Runtype::Internal::Types::Enum
8
+
9
+ SHARED = "shared"
10
+ ALIAS = "alias"
11
+ VERSION = "version"
12
+ end
13
+ end
14
+ end
15
+ end
@@ -8,6 +8,8 @@ module Runtype
8
8
 
9
9
  field :inject_summary, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "injectSummary"
10
10
 
11
+ field :pointer_scope, -> { Runtype::Dispatch::Types::PostV1DispatchRequestZeroAgentMemoryPointerScope }, optional: true, nullable: false, api_name: "pointerScope"
12
+
11
13
  field :profile_template, -> { String }, optional: true, nullable: false, api_name: "profileTemplate"
12
14
  end
13
15
  end
@@ -0,0 +1,15 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Dispatch
5
+ module Types
6
+ module PostV1DispatchRequestZeroAgentMemoryPointerScope
7
+ extend Runtype::Internal::Types::Enum
8
+
9
+ SHARED = "shared"
10
+ ALIAS = "alias"
11
+ VERSION = "version"
12
+ end
13
+ end
14
+ end
15
+ end
@@ -4,10 +4,18 @@ module Runtype
4
4
  module Evals
5
5
  module Types
6
6
  class GetV1EvalIDResultsResponse < Internal::Types::Model
7
+ field :agent_target_alias, -> { String }, optional: true, nullable: false, api_name: "agentTargetAlias"
8
+
9
+ field :agent_target_resolution, -> { Runtype::Evals::Types::GetV1EvalIDResultsResponseAgentTargetResolution }, optional: true, nullable: false, api_name: "agentTargetResolution"
10
+
11
+ field :agent_version_id, -> { String }, optional: true, nullable: false, api_name: "agentVersionId"
12
+
7
13
  field :batch_execution_id, -> { String }, optional: false, nullable: false, api_name: "batchExecutionId"
8
14
 
9
15
  field :case_errors, -> { Internal::Types::Array[Runtype::Evals::Types::GetV1EvalIDResultsResponseCaseErrorsItem] }, optional: false, nullable: false, api_name: "caseErrors"
10
16
 
17
+ field :case_manifest_hash, -> { String }, optional: true, nullable: false, api_name: "caseManifestHash"
18
+
11
19
  field :completed_at, -> { String }, optional: true, nullable: false, api_name: "completedAt"
12
20
 
13
21
  field :eval_config, -> { Object }, optional: true, nullable: false, api_name: "evalConfig"
@@ -16,6 +24,8 @@ module Runtype
16
24
 
17
25
  field :eval_name, -> { String }, optional: true, nullable: false, api_name: "evalName"
18
26
 
27
+ field :evaluator_fingerprint, -> { String }, optional: true, nullable: false, api_name: "evaluatorFingerprint"
28
+
19
29
  field :failed_records, -> { Integer }, optional: false, nullable: false, api_name: "failedRecords"
20
30
 
21
31
  field :flow_id, -> { String }, optional: false, nullable: true, api_name: "flowId"
@@ -0,0 +1,15 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Evals
5
+ module Types
6
+ module GetV1EvalIDResultsResponseAgentTargetResolution
7
+ extend Runtype::Internal::Types::Enum
8
+
9
+ ALIAS = "alias"
10
+ VERSION = "version"
11
+ LEGACY_LIVE_ROW = "legacy-live-row"
12
+ end
13
+ end
14
+ end
15
+ end
@@ -8,6 +8,7 @@ module Runtype
8
8
 
9
9
  RUNTIME = "runtime"
10
10
  LEGACY = "legacy"
11
+ EXTERNAL = "external"
11
12
  end
12
13
  end
13
14
  end
@@ -4,6 +4,8 @@ module Runtype
4
4
  module Evals
5
5
  module Types
6
6
  class PostV1EvalRunRequest < Internal::Types::Model
7
+ field :agent, -> { Runtype::Evals::Types::PostV1EvalRunRequestAgent }, optional: true, nullable: false
8
+
7
9
  field :definition, -> { Runtype::Evals::Types::PostV1EvalRunRequestDefinition }, optional: true, nullable: false
8
10
 
9
11
  field :model_override, -> { String }, optional: true, nullable: false, api_name: "modelOverride"
@@ -0,0 +1,15 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Evals
5
+ module Types
6
+ # Version selector for an Agent target. Supply at most one of alias or versionId; the run resolves it once and
7
+ # every case executes that version.
8
+ class PostV1EvalRunRequestAgent < Internal::Types::Model
9
+ field :alias_, -> { String }, optional: true, nullable: false, api_name: "alias"
10
+
11
+ field :version_id, -> { String }, optional: true, nullable: false, api_name: "versionId"
12
+ end
13
+ end
14
+ end
15
+ end
@@ -4,6 +4,8 @@ module Runtype
4
4
  module Evals
5
5
  module Types
6
6
  class PostV1EvalSubmitRequest < Internal::Types::Model
7
+ field :agent, -> { Runtype::Evals::Types::PostV1EvalSubmitRequestAgent }, optional: true, nullable: false
8
+
7
9
  field :eval_config, -> { Runtype::Types::EvalConfigRequest }, optional: true, nullable: false, api_name: "evalConfig"
8
10
 
9
11
  field :eval_configs, -> { Internal::Types::Array[Runtype::Types::EvalConfigRequest] }, optional: true, nullable: false, api_name: "evalConfigs"
@@ -0,0 +1,15 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Evals
5
+ module Types
6
+ # Version selector for an agentId target. Supply at most one of alias or versionId; the run resolves it once and
7
+ # every case executes that version.
8
+ class PostV1EvalSubmitRequestAgent < Internal::Types::Model
9
+ field :alias_, -> { String }, optional: true, nullable: false, api_name: "alias"
10
+
11
+ field :version_id, -> { String }, optional: true, nullable: false, api_name: "versionId"
12
+ end
13
+ end
14
+ end
15
+ end
@@ -6,6 +6,8 @@ module Runtype
6
6
  class PostV1EvalSuitesIDRunRequest < Internal::Types::Model
7
7
  field :id, -> { String }, optional: false, nullable: false
8
8
 
9
+ field :agent, -> { Runtype::Types::EvalAgentSelector }, optional: true, nullable: false
10
+
9
11
  field :mode, -> { Runtype::Evals::Types::PostV1EvalSuitesIDRunRequestMode }, optional: true, nullable: false
10
12
 
11
13
  field :model_override, -> { String }, optional: true, nullable: false, api_name: "modelOverride"
@@ -10,6 +10,49 @@ module Runtype
10
10
  @client = client
11
11
  end
12
12
 
13
+ # Read the delivery independently of its host execution. Applied means durably incorporated into context, not
14
+ # model compliance. Settled shares the host outcome; not_applied means the host ended before consuming this input.
15
+ # Receipts are retained within the session retry window.
16
+ #
17
+ # @param request_options [Hash]
18
+ # @param params [Hash]
19
+ # @option request_options [String] :base_url
20
+ # @option request_options [Hash{String => Object}] :additional_headers
21
+ # @option request_options [Hash{String => Object}] :additional_query_parameters
22
+ # @option request_options [Hash{String => Object}] :additional_body_parameters
23
+ # @option request_options [Integer] :timeout_in_seconds
24
+ # @option params [String] :execution_id
25
+ # @option params [String] :delivery_id
26
+ #
27
+ # @example
28
+ # client.executions.inspect_a_durable_input_delivery(
29
+ # execution_id: "executionId",
30
+ # delivery_id: "deliveryId"
31
+ # )
32
+ #
33
+ # @return [Runtype::Types::InputDeliveryReceipt]
34
+ def inspect_a_durable_input_delivery(request_options: {}, **params)
35
+ params = Runtype::Internal::Types::Utils.normalize_keys(params)
36
+ request = Runtype::Internal::JSON::Request.new(
37
+ base_url: request_options[:base_url],
38
+ method: "GET",
39
+ path: "v1/executions/#{URI.encode_uri_component(params[:execution_id].to_s)}/deliveries/#{URI.encode_uri_component(params[:delivery_id].to_s)}",
40
+ request_options: request_options
41
+ )
42
+ begin
43
+ response = @client.send(request)
44
+ rescue Net::HTTPRequestTimeout
45
+ raise Runtype::Errors::TimeoutError
46
+ end
47
+ code = response.code.to_i
48
+ if code.between?(200, 299)
49
+ Runtype::Types::InputDeliveryReceipt.load(response.body)
50
+ else
51
+ error_class = Runtype::Errors::ResponseError.subclass_for_code(code)
52
+ raise error_class.new(response.body, code: code)
53
+ end
54
+ end
55
+
13
56
  # Execution-scoped alias of `GET /v1/agents/{id}/executions/{executionId}/events`: reconnect to a durable turn and
14
57
  # replay-and-tail its Server-Sent Events without already knowing which agent ran it. The agent is resolved from
15
58
  # the execution's own persisted record, so a run started through `/v1/dispatch` reconnects by execution id alone;
@@ -0,0 +1,13 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Executions
5
+ module Types
6
+ class GetV1ExecutionsExecutionIDDeliveriesDeliveryIDRequest < Internal::Types::Model
7
+ field :execution_id, -> { String }, optional: false, nullable: false, api_name: "executionId"
8
+
9
+ field :delivery_id, -> { String }, optional: false, nullable: false, api_name: "deliveryId"
10
+ end
11
+ end
12
+ end
13
+ end
@@ -339,11 +339,10 @@ module Runtype
339
339
  raise error_class.new(response.body, code: code)
340
340
  end
341
341
 
342
- # **Limited preview — not yet generally available.** This endpoint is dark-launched and returns `404 Not Found` in
343
- # production until GA; it is only reachable in non-production environments today.
344
- #
345
342
  # Export a fully-resolved, self-contained flow definition that the @runtypelabs/runtime package can consume
346
- # directly at boot. All step configs are inlined; no live DB queries are needed at execution time.
343
+ # directly at boot. All step configs are inlined; no live DB queries are needed at execution time. Requires the
344
+ # `RUNTIME:EXPORT` scope and an Enterprise plan (the `byoc` entitlement); an unentitled account receives `403`
345
+ # with code `BYOC_PLAN_REQUIRED` in every environment.
347
346
  #
348
347
  # The response carries `hostDependencies`: the runtime seams the exported artifact needs a host to wire before it
349
348
  # can run everything it describes. A durable-class step (`wait-until` or `crawl`) anywhere in the flow's
@@ -8,6 +8,7 @@ module Runtype
8
8
 
9
9
  RUNTIME = "runtime"
10
10
  LEGACY = "legacy"
11
+ EXTERNAL = "external"
11
12
  end
12
13
  end
13
14
  end
@@ -21,6 +21,7 @@ module Runtype
21
21
  # @option request_options [Integer] :timeout_in_seconds
22
22
  # @option params [String, nil] :limit
23
23
  # @option params [String, nil] :cursor
24
+ # @option params [String, nil] :include_count
24
25
  # @option params [String, nil] :surface_id
25
26
  # @option params [String, nil] :status
26
27
  # @option params [String, nil] :agent_mode
@@ -35,6 +36,7 @@ module Runtype
35
36
  query_params = {}
36
37
  query_params["limit"] = params[:limit] if params.key?(:limit)
37
38
  query_params["cursor"] = params[:cursor] if params.key?(:cursor)
39
+ query_params["includeCount"] = params[:include_count] if params.key?(:include_count)
38
40
  query_params["surfaceId"] = params[:surface_id] if params.key?(:surface_id)
39
41
  query_params["status"] = params[:status] if params.key?(:status)
40
42
  query_params["agentMode"] = params[:agent_mode] if params.key?(:agent_mode)
@@ -8,6 +8,8 @@ module Runtype
8
8
 
9
9
  field :cursor, -> { String }, optional: true, nullable: false
10
10
 
11
+ field :include_count, -> { String }, optional: true, nullable: false, api_name: "includeCount"
12
+
11
13
  field :surface_id, -> { String }, optional: true, nullable: false, api_name: "surfaceId"
12
14
 
13
15
  field :status, -> { String }, optional: true, nullable: false
@@ -8,6 +8,7 @@ module Runtype
8
8
 
9
9
  RUNTIME = "runtime"
10
10
  LEGACY = "legacy"
11
+ EXTERNAL = "external"
11
12
  end
12
13
  end
13
14
  end
@@ -8,6 +8,7 @@ module Runtype
8
8
 
9
9
  RUNTIME = "runtime"
10
10
  LEGACY = "legacy"
11
+ EXTERNAL = "external"
11
12
  end
12
13
  end
13
14
  end
@@ -8,6 +8,7 @@ module Runtype
8
8
 
9
9
  RUNTIME = "runtime"
10
10
  LEGACY = "legacy"
11
+ EXTERNAL = "external"
11
12
  end
12
13
  end
13
14
  end
@@ -8,6 +8,7 @@ module Runtype
8
8
 
9
9
  RUNTIME = "runtime"
10
10
  LEGACY = "legacy"
11
+ EXTERNAL = "external"
11
12
  end
12
13
  end
13
14
  end
@@ -0,0 +1,17 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Types
5
+ # Source-organization ids and hashes this version was promoted from, linked on the receipt. Provenance only: it
6
+ # never authorizes anything, and the target credentials alone decide what the activation may do.
7
+ class AgentDeploymentPromotion < Internal::Types::Model
8
+ field :source_agent_id, -> { String }, optional: true, nullable: false, api_name: "sourceAgentId"
9
+
10
+ field :source_commit, -> { String }, optional: true, nullable: false, api_name: "sourceCommit"
11
+
12
+ field :source_content_hash, -> { String }, optional: true, nullable: false, api_name: "sourceContentHash"
13
+
14
+ field :source_version_id, -> { String }, optional: true, nullable: false, api_name: "sourceVersionId"
15
+ end
16
+ end
17
+ end
@@ -0,0 +1,19 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Types
5
+ class AgentEnsurePreviewAliasLimit < Internal::Types::Model
6
+ field :active, -> { Integer }, optional: false, nullable: false
7
+
8
+ field :code, -> { Runtype::Types::AgentEnsurePreviewAliasLimitCode }, optional: false, nullable: false
9
+
10
+ field :error, -> { String }, optional: false, nullable: false
11
+
12
+ field :limit, -> { Integer }, optional: false, nullable: false
13
+
14
+ field :message, -> { String }, optional: false, nullable: false
15
+
16
+ field :scope, -> { Runtype::Types::AgentEnsurePreviewAliasLimitScope }, optional: false, nullable: false
17
+ end
18
+ end
19
+ end
@@ -0,0 +1,11 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Types
5
+ module AgentEnsurePreviewAliasLimitCode
6
+ extend Runtype::Internal::Types::Enum
7
+
8
+ PREVIEW_ALIAS_LIMIT = "PREVIEW_ALIAS_LIMIT"
9
+ end
10
+ end
11
+ end
@@ -0,0 +1,12 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Types
5
+ module AgentEnsurePreviewAliasLimitScope
6
+ extend Runtype::Internal::Types::Enum
7
+
8
+ ORGANIZATION = "organization"
9
+ AGENT = "agent"
10
+ end
11
+ end
12
+ end
@@ -7,6 +7,8 @@ module Runtype
7
7
 
8
8
  field :inject_summary, -> { Internal::Types::Boolean }, optional: true, nullable: false, api_name: "injectSummary"
9
9
 
10
+ field :pointer_scope, -> { Runtype::Types::AgentPullResponseDefinitionConfigMemoryPointerScope }, optional: true, nullable: false, api_name: "pointerScope"
11
+
10
12
  field :profile_template, -> { String }, optional: true, nullable: false, api_name: "profileTemplate"
11
13
  end
12
14
  end
@@ -0,0 +1,13 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Types
5
+ module AgentPullResponseDefinitionConfigMemoryPointerScope
6
+ extend Runtype::Internal::Types::Enum
7
+
8
+ SHARED = "shared"
9
+ ALIAS = "alias"
10
+ VERSION = "version"
11
+ end
12
+ end
13
+ end
@@ -3,10 +3,20 @@
3
3
  module Runtype
4
4
  module Types
5
5
  class AsyncDispatchHandle < Internal::Types::Model
6
+ field :accepted, -> { Internal::Types::Boolean }, optional: true, nullable: false
7
+
6
8
  field :claude_managed_agent_id, -> { String }, optional: true, nullable: false, api_name: "claudeManagedAgentId"
7
9
 
8
10
  field :conversation_id, -> { String }, optional: true, nullable: false, api_name: "conversationId"
9
11
 
12
+ field :delivery_id, -> { String }, optional: true, nullable: false, api_name: "deliveryId"
13
+
14
+ field :delivery_status, -> { Runtype::Types::AsyncDispatchHandleDeliveryStatus }, optional: true, nullable: false, api_name: "deliveryStatus"
15
+
16
+ field :delivery_status_url, -> { String }, optional: true, nullable: false, api_name: "deliveryStatusUrl"
17
+
18
+ field :events_url, -> { String }, optional: true, nullable: false, api_name: "eventsUrl"
19
+
10
20
  field :execution_id, -> { String }, optional: false, nullable: false, api_name: "executionId"
11
21
 
12
22
  field :status, -> { Runtype::Types::AsyncDispatchHandleStatus }, optional: false, nullable: false
@@ -0,0 +1,14 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Types
5
+ module AsyncDispatchHandleDeliveryStatus
6
+ extend Runtype::Internal::Types::Enum
7
+
8
+ PENDING = "pending"
9
+ APPLIED = "applied"
10
+ SETTLED = "settled"
11
+ NOT_APPLIED = "not_applied"
12
+ end
13
+ end
14
+ end
@@ -7,6 +7,11 @@ module Runtype
7
7
 
8
8
  QUEUED = "queued"
9
9
  RUNNING = "running"
10
+ PAUSED = "paused"
11
+ COMPLETED = "completed"
12
+ FAILED = "failed"
13
+ CANCELLED = "cancelled"
14
+ INTERRUPTED = "interrupted"
10
15
  end
11
16
  end
12
17
  end
@@ -0,0 +1,19 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Types
5
+ class ClientInputDeliveryReceipt < Internal::Types::Model
6
+ field :delivery_id, -> { String }, optional: false, nullable: false, api_name: "deliveryId"
7
+
8
+ field :execution_id, -> { String }, optional: false, nullable: false, api_name: "executionId"
9
+
10
+ field :initial, -> { Internal::Types::Boolean }, optional: false, nullable: false
11
+
12
+ field :outcome, -> { String }, optional: true, nullable: false
13
+
14
+ field :sequence, -> { Integer }, optional: false, nullable: false
15
+
16
+ field :status, -> { Runtype::Types::ClientInputDeliveryReceiptStatus }, optional: false, nullable: false
17
+ end
18
+ end
19
+ end
@@ -0,0 +1,14 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Runtype
4
+ module Types
5
+ module ClientInputDeliveryReceiptStatus
6
+ extend Runtype::Internal::Types::Enum
7
+
8
+ PENDING = "pending"
9
+ APPLIED = "applied"
10
+ SETTLED = "settled"
11
+ NOT_APPLIED = "not_applied"
12
+ end
13
+ end
14
+ end