@heddleagent/execution-host-client 6.1.0 → 6.2.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 (54) hide show
  1. package/README.md +42 -3
  2. package/dist/agentcore/agentcore-execution-host.d.ts +4 -3
  3. package/dist/agentcore/agentcore-execution-host.d.ts.map +1 -1
  4. package/dist/agentcore/agentcore-execution-host.js +4 -0
  5. package/dist/agentcore/agentcore-execution-host.js.map +1 -1
  6. package/dist/authority/jose-execution-authority.js +2 -2
  7. package/dist/authority/jose-execution-authority.js.map +1 -1
  8. package/dist/contracts/index.d.ts +106 -3
  9. package/dist/contracts/index.d.ts.map +1 -1
  10. package/dist/contracts/index.js +67 -2
  11. package/dist/contracts/index.js.map +1 -1
  12. package/dist/conversation/index.d.ts +1 -1
  13. package/dist/conversation/index.d.ts.map +1 -1
  14. package/dist/conversation/index.js.map +1 -1
  15. package/dist/conversation/types.d.ts +4 -2
  16. package/dist/conversation/types.d.ts.map +1 -1
  17. package/dist/conversation/types.js.map +1 -1
  18. package/dist/heartbeat/hosted-heartbeat-agent-execution-transport.d.ts +14 -0
  19. package/dist/heartbeat/hosted-heartbeat-agent-execution-transport.d.ts.map +1 -0
  20. package/dist/heartbeat/hosted-heartbeat-agent-execution-transport.js +38 -0
  21. package/dist/heartbeat/hosted-heartbeat-agent-execution-transport.js.map +1 -0
  22. package/dist/heartbeat/hosted-heartbeat-task-service.d.ts +22 -0
  23. package/dist/heartbeat/hosted-heartbeat-task-service.d.ts.map +1 -0
  24. package/dist/heartbeat/hosted-heartbeat-task-service.js +96 -0
  25. package/dist/heartbeat/hosted-heartbeat-task-service.js.map +1 -0
  26. package/dist/heartbeat/index.d.ts +5 -0
  27. package/dist/heartbeat/index.d.ts.map +1 -0
  28. package/dist/heartbeat/index.js +4 -0
  29. package/dist/heartbeat/index.js.map +1 -0
  30. package/dist/heartbeat/types.d.ts +83 -0
  31. package/dist/heartbeat/types.d.ts.map +1 -0
  32. package/dist/heartbeat/types.js +17 -0
  33. package/dist/heartbeat/types.js.map +1 -0
  34. package/dist/http-sse/direct-http-execution-host.d.ts +4 -3
  35. package/dist/http-sse/direct-http-execution-host.d.ts.map +1 -1
  36. package/dist/http-sse/direct-http-execution-host.js +56 -21
  37. package/dist/http-sse/direct-http-execution-host.js.map +1 -1
  38. package/dist/http-sse/index.d.ts +1 -1
  39. package/dist/http-sse/index.d.ts.map +1 -1
  40. package/dist/http-sse/index.js.map +1 -1
  41. package/dist/http-sse/types.d.ts +11 -1
  42. package/dist/http-sse/types.d.ts.map +1 -1
  43. package/dist/http-sse/types.js.map +1 -1
  44. package/dist/index.d.ts +1 -0
  45. package/dist/index.d.ts.map +1 -1
  46. package/dist/index.js +1 -0
  47. package/dist/index.js.map +1 -1
  48. package/package.json +5 -1
  49. package/spec/v1/README.md +14 -4
  50. package/spec/v1/fixtures/manifest.json +12 -0
  51. package/spec/v1/fixtures/valid-heartbeat-request.json +23 -0
  52. package/spec/v1/fixtures/valid-heartbeat-result.sse +13 -0
  53. package/spec/v1/openapi.json +513 -6
  54. package/spec/v1/schema-bundle.json +499 -2
@@ -78,6 +78,170 @@
78
78
  ],
79
79
  "additionalProperties": false
80
80
  },
81
+ "HeartbeatTaskRequest": {
82
+ "type": "object",
83
+ "properties": {
84
+ "schemaVersion": {
85
+ "type": "number",
86
+ "const": 1
87
+ },
88
+ "kind": {
89
+ "type": "string",
90
+ "const": "heartbeat-task"
91
+ },
92
+ "invocationId": {
93
+ "type": "string",
94
+ "minLength": 1,
95
+ "maxLength": 128,
96
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
97
+ },
98
+ "taskId": {
99
+ "type": "string",
100
+ "minLength": 1,
101
+ "maxLength": 128,
102
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
103
+ },
104
+ "task": {
105
+ "type": "string",
106
+ "minLength": 1,
107
+ "maxLength": 200000,
108
+ "x-heddle-trimmed": true
109
+ },
110
+ "checkpoint": {
111
+ "type": "object",
112
+ "propertyNames": {
113
+ "type": "string"
114
+ },
115
+ "additionalProperties": {
116
+ "$ref": "#/$defs/HeartbeatTaskRequest/$defs/__schema0"
117
+ }
118
+ },
119
+ "runContext": {
120
+ "type": "object",
121
+ "properties": {
122
+ "currentDateTime": {
123
+ "type": "string",
124
+ "format": "date-time",
125
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
126
+ },
127
+ "intervalMs": {
128
+ "type": "integer",
129
+ "exclusiveMinimum": 0,
130
+ "maximum": 9007199254740991
131
+ },
132
+ "continuationMode": {
133
+ "type": "string",
134
+ "enum": [
135
+ "operator",
136
+ "agent"
137
+ ]
138
+ },
139
+ "nextRunAt": {
140
+ "type": "string",
141
+ "format": "date-time",
142
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
143
+ },
144
+ "previousRunAt": {
145
+ "type": "string",
146
+ "format": "date-time",
147
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
148
+ },
149
+ "previousRunId": {
150
+ "type": "string",
151
+ "minLength": 1,
152
+ "maxLength": 128,
153
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
154
+ }
155
+ },
156
+ "required": [
157
+ "currentDateTime",
158
+ "intervalMs"
159
+ ],
160
+ "additionalProperties": false
161
+ },
162
+ "model": {
163
+ "type": "string",
164
+ "minLength": 1,
165
+ "maxLength": 512
166
+ },
167
+ "reasoningEffort": {
168
+ "type": "string",
169
+ "enum": [
170
+ "none",
171
+ "low",
172
+ "medium",
173
+ "high",
174
+ "ultrahigh",
175
+ "max"
176
+ ]
177
+ },
178
+ "maxSteps": {
179
+ "type": "integer",
180
+ "exclusiveMinimum": 0,
181
+ "maximum": 10000
182
+ },
183
+ "searchIgnoreDirs": {
184
+ "maxItems": 1000,
185
+ "type": "array",
186
+ "items": {
187
+ "type": "string",
188
+ "minLength": 1,
189
+ "maxLength": 1024
190
+ }
191
+ },
192
+ "systemContext": {
193
+ "type": "string",
194
+ "maxLength": 200000
195
+ },
196
+ "deadlineAt": {
197
+ "type": "string",
198
+ "format": "date-time",
199
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
200
+ }
201
+ },
202
+ "required": [
203
+ "schemaVersion",
204
+ "kind",
205
+ "invocationId",
206
+ "taskId",
207
+ "task",
208
+ "runContext"
209
+ ],
210
+ "additionalProperties": false,
211
+ "$defs": {
212
+ "__schema0": {
213
+ "anyOf": [
214
+ {
215
+ "type": "string"
216
+ },
217
+ {
218
+ "type": "number"
219
+ },
220
+ {
221
+ "type": "boolean"
222
+ },
223
+ {
224
+ "type": "null"
225
+ },
226
+ {
227
+ "type": "array",
228
+ "items": {
229
+ "$ref": "#/$defs/HeartbeatTaskRequest/$defs/__schema0"
230
+ }
231
+ },
232
+ {
233
+ "type": "object",
234
+ "propertyNames": {
235
+ "type": "string"
236
+ },
237
+ "additionalProperties": {
238
+ "$ref": "#/$defs/HeartbeatTaskRequest/$defs/__schema0"
239
+ }
240
+ }
241
+ ]
242
+ }
243
+ }
244
+ },
81
245
  "RuntimePublicResult": {
82
246
  "type": "object",
83
247
  "properties": {
@@ -428,6 +592,333 @@
428
592
  }
429
593
  ]
430
594
  },
595
+ "HeartbeatStreamEvent": {
596
+ "oneOf": [
597
+ {
598
+ "type": "object",
599
+ "properties": {
600
+ "schemaVersion": {
601
+ "type": "number",
602
+ "const": 1
603
+ },
604
+ "invocationId": {
605
+ "type": "string",
606
+ "minLength": 1,
607
+ "maxLength": 128,
608
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
609
+ },
610
+ "runId": {
611
+ "type": "string",
612
+ "minLength": 1,
613
+ "maxLength": 128,
614
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
615
+ },
616
+ "sequence": {
617
+ "type": "number",
618
+ "const": 0
619
+ },
620
+ "timestamp": {
621
+ "type": "string",
622
+ "format": "date-time",
623
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
624
+ },
625
+ "kind": {
626
+ "type": "string",
627
+ "const": "accepted"
628
+ }
629
+ },
630
+ "required": [
631
+ "schemaVersion",
632
+ "invocationId",
633
+ "runId",
634
+ "sequence",
635
+ "timestamp",
636
+ "kind"
637
+ ],
638
+ "additionalProperties": false
639
+ },
640
+ {
641
+ "type": "object",
642
+ "properties": {
643
+ "schemaVersion": {
644
+ "type": "number",
645
+ "const": 1
646
+ },
647
+ "invocationId": {
648
+ "type": "string",
649
+ "minLength": 1,
650
+ "maxLength": 128,
651
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
652
+ },
653
+ "runId": {
654
+ "type": "string",
655
+ "minLength": 1,
656
+ "maxLength": 128,
657
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
658
+ },
659
+ "sequence": {
660
+ "type": "integer",
661
+ "minimum": 0,
662
+ "maximum": 9007199254740991
663
+ },
664
+ "timestamp": {
665
+ "type": "string",
666
+ "format": "date-time",
667
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
668
+ },
669
+ "kind": {
670
+ "type": "string",
671
+ "const": "activity"
672
+ },
673
+ "activity": {
674
+ "$ref": "#/$defs/HeartbeatStreamEvent/$defs/__schema0"
675
+ }
676
+ },
677
+ "required": [
678
+ "schemaVersion",
679
+ "invocationId",
680
+ "runId",
681
+ "sequence",
682
+ "timestamp",
683
+ "kind",
684
+ "activity"
685
+ ],
686
+ "additionalProperties": false
687
+ },
688
+ {
689
+ "type": "object",
690
+ "properties": {
691
+ "schemaVersion": {
692
+ "type": "number",
693
+ "const": 1
694
+ },
695
+ "invocationId": {
696
+ "type": "string",
697
+ "minLength": 1,
698
+ "maxLength": 128,
699
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
700
+ },
701
+ "runId": {
702
+ "type": "string",
703
+ "minLength": 1,
704
+ "maxLength": 128,
705
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
706
+ },
707
+ "sequence": {
708
+ "type": "integer",
709
+ "minimum": 0,
710
+ "maximum": 9007199254740991
711
+ },
712
+ "timestamp": {
713
+ "type": "string",
714
+ "format": "date-time",
715
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
716
+ },
717
+ "kind": {
718
+ "type": "string",
719
+ "const": "result"
720
+ },
721
+ "result": {
722
+ "type": "object",
723
+ "propertyNames": {
724
+ "type": "string"
725
+ },
726
+ "additionalProperties": {
727
+ "$ref": "#/$defs/HeartbeatStreamEvent/$defs/__schema1"
728
+ }
729
+ }
730
+ },
731
+ "required": [
732
+ "schemaVersion",
733
+ "invocationId",
734
+ "runId",
735
+ "sequence",
736
+ "timestamp",
737
+ "kind",
738
+ "result"
739
+ ],
740
+ "additionalProperties": false
741
+ },
742
+ {
743
+ "type": "object",
744
+ "properties": {
745
+ "schemaVersion": {
746
+ "type": "number",
747
+ "const": 1
748
+ },
749
+ "invocationId": {
750
+ "type": "string",
751
+ "minLength": 1,
752
+ "maxLength": 128,
753
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
754
+ },
755
+ "runId": {
756
+ "type": "string",
757
+ "minLength": 1,
758
+ "maxLength": 128,
759
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
760
+ },
761
+ "sequence": {
762
+ "type": "integer",
763
+ "minimum": 0,
764
+ "maximum": 9007199254740991
765
+ },
766
+ "timestamp": {
767
+ "type": "string",
768
+ "format": "date-time",
769
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
770
+ },
771
+ "kind": {
772
+ "type": "string",
773
+ "const": "cancelled"
774
+ },
775
+ "reason": {
776
+ "type": "string"
777
+ }
778
+ },
779
+ "required": [
780
+ "schemaVersion",
781
+ "invocationId",
782
+ "runId",
783
+ "sequence",
784
+ "timestamp",
785
+ "kind",
786
+ "reason"
787
+ ],
788
+ "additionalProperties": false
789
+ },
790
+ {
791
+ "type": "object",
792
+ "properties": {
793
+ "schemaVersion": {
794
+ "type": "number",
795
+ "const": 1
796
+ },
797
+ "invocationId": {
798
+ "type": "string",
799
+ "minLength": 1,
800
+ "maxLength": 128,
801
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
802
+ },
803
+ "runId": {
804
+ "type": "string",
805
+ "minLength": 1,
806
+ "maxLength": 128,
807
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@-]*$"
808
+ },
809
+ "sequence": {
810
+ "type": "integer",
811
+ "minimum": 0,
812
+ "maximum": 9007199254740991
813
+ },
814
+ "timestamp": {
815
+ "type": "string",
816
+ "format": "date-time",
817
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
818
+ },
819
+ "kind": {
820
+ "type": "string",
821
+ "const": "error"
822
+ },
823
+ "error": {
824
+ "type": "object",
825
+ "properties": {
826
+ "code": {
827
+ "type": "string",
828
+ "minLength": 1,
829
+ "maxLength": 128,
830
+ "pattern": "^[a-z0-9_]+$"
831
+ },
832
+ "message": {
833
+ "type": "string",
834
+ "minLength": 1,
835
+ "maxLength": 1600
836
+ }
837
+ },
838
+ "required": [
839
+ "code",
840
+ "message"
841
+ ],
842
+ "additionalProperties": false
843
+ }
844
+ },
845
+ "required": [
846
+ "schemaVersion",
847
+ "invocationId",
848
+ "runId",
849
+ "sequence",
850
+ "timestamp",
851
+ "kind",
852
+ "error"
853
+ ],
854
+ "additionalProperties": false
855
+ }
856
+ ],
857
+ "$defs": {
858
+ "__schema0": {
859
+ "anyOf": [
860
+ {
861
+ "type": "string"
862
+ },
863
+ {
864
+ "type": "number"
865
+ },
866
+ {
867
+ "type": "boolean"
868
+ },
869
+ {
870
+ "type": "null"
871
+ },
872
+ {
873
+ "type": "array",
874
+ "items": {
875
+ "$ref": "#/$defs/HeartbeatStreamEvent/$defs/__schema0"
876
+ }
877
+ },
878
+ {
879
+ "type": "object",
880
+ "propertyNames": {
881
+ "type": "string"
882
+ },
883
+ "additionalProperties": {
884
+ "$ref": "#/$defs/HeartbeatStreamEvent/$defs/__schema0"
885
+ }
886
+ }
887
+ ]
888
+ },
889
+ "__schema1": {
890
+ "anyOf": [
891
+ {
892
+ "type": "string"
893
+ },
894
+ {
895
+ "type": "number"
896
+ },
897
+ {
898
+ "type": "boolean"
899
+ },
900
+ {
901
+ "type": "null"
902
+ },
903
+ {
904
+ "type": "array",
905
+ "items": {
906
+ "$ref": "#/$defs/HeartbeatStreamEvent/$defs/__schema1"
907
+ }
908
+ },
909
+ {
910
+ "type": "object",
911
+ "propertyNames": {
912
+ "type": "string"
913
+ },
914
+ "additionalProperties": {
915
+ "$ref": "#/$defs/HeartbeatStreamEvent/$defs/__schema1"
916
+ }
917
+ }
918
+ ]
919
+ }
920
+ }
921
+ },
431
922
  "ExecutionAssertionClaims": {
432
923
  "type": "object",
433
924
  "properties": {
@@ -470,7 +961,10 @@
470
961
  },
471
962
  "workflow": {
472
963
  "type": "string",
473
- "const": "conversation-turn"
964
+ "enum": [
965
+ "conversation-turn",
966
+ "heartbeat-task"
967
+ ]
474
968
  },
475
969
  "sub": {
476
970
  "type": "string",
@@ -559,7 +1053,10 @@
559
1053
  },
560
1054
  "workflow": {
561
1055
  "type": "string",
562
- "const": "conversation-turn"
1056
+ "enum": [
1057
+ "conversation-turn",
1058
+ "heartbeat-task"
1059
+ ]
563
1060
  },
564
1061
  "serverId": {
565
1062
  "type": "string",