@runtypelabs/persona 3.36.0 → 4.0.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 (48) hide show
  1. package/README.md +0 -1
  2. package/dist/animations/glyph-cycle.d.cts +1 -1
  3. package/dist/animations/glyph-cycle.d.ts +1 -1
  4. package/dist/animations/{types-DgYsuwXL.d.cts → types-B_xbfvR0.d.cts} +263 -181
  5. package/dist/animations/{types-DgYsuwXL.d.ts → types-B_xbfvR0.d.ts} +263 -181
  6. package/dist/animations/wipe.d.cts +1 -1
  7. package/dist/animations/wipe.d.ts +1 -1
  8. package/dist/codegen.cjs +1 -1
  9. package/dist/codegen.js +1 -1
  10. package/dist/index.cjs +47 -47
  11. package/dist/index.cjs.map +1 -1
  12. package/dist/index.d.cts +328 -821
  13. package/dist/index.d.ts +328 -821
  14. package/dist/index.global.js +39 -39
  15. package/dist/index.global.js.map +1 -1
  16. package/dist/index.js +47 -47
  17. package/dist/index.js.map +1 -1
  18. package/dist/install.global.js +1 -1
  19. package/dist/install.global.js.map +1 -1
  20. package/dist/smart-dom-reader.d.cts +268 -181
  21. package/dist/smart-dom-reader.d.ts +268 -181
  22. package/dist/theme-editor-preview.cjs +41 -41
  23. package/dist/theme-editor-preview.d.cts +268 -181
  24. package/dist/theme-editor-preview.d.ts +268 -181
  25. package/dist/theme-editor-preview.js +41 -41
  26. package/dist/theme-editor.d.cts +268 -181
  27. package/dist/theme-editor.d.ts +268 -181
  28. package/package.json +1 -1
  29. package/src/client.test.ts +506 -1003
  30. package/src/client.ts +676 -909
  31. package/src/components/tool-bubble.ts +46 -33
  32. package/src/generated/runtype-openapi-contract.ts +211 -714
  33. package/src/index-core.ts +2 -3
  34. package/src/install.test.ts +1 -34
  35. package/src/install.ts +1 -22
  36. package/src/runtime/init.test.ts +8 -67
  37. package/src/runtime/init.ts +2 -17
  38. package/src/session.test.ts +8 -8
  39. package/src/session.ts +1 -1
  40. package/src/types.ts +11 -2
  41. package/src/ui.postprocess.test.ts +107 -0
  42. package/src/ui.ts +40 -5
  43. package/src/utils/__fixtures__/unified-translator.oracle.ts +717 -0
  44. package/src/utils/copy-selection.test.ts +37 -0
  45. package/src/utils/copy-selection.ts +19 -0
  46. package/src/utils/event-stream-capture.test.ts +9 -64
  47. package/src/utils/sequence-buffer.test.ts +0 -256
  48. package/src/utils/sequence-buffer.ts +0 -130
package/dist/index.d.ts CHANGED
@@ -778,57 +778,80 @@ interface CreateThemeOptions {
778
778
  extend?: PersonaTheme;
779
779
  }
780
780
 
781
- type RuntypeAgentSSEEvent = {
782
- agentId: string;
783
- agentName: string;
784
- config?: {
785
- enableReflection?: boolean;
786
- model?: string;
787
- };
781
+ type RuntypeExecutionStreamEvent = ({
782
+ agentId?: string;
783
+ agentName?: string;
784
+ config?: Record<string, unknown>;
788
785
  executionId: string;
789
- maxTurns: number;
786
+ flowId?: string;
787
+ flowName?: string;
788
+ kind: "agent" | "flow";
789
+ maxTurns?: number;
790
790
  seq: number;
791
+ source?: string;
791
792
  startedAt: string;
792
- type: "agent_start";
793
- } | {
793
+ totalSteps?: number;
794
+ type: "execution_start";
795
+ }) | ({
796
+ completedAt?: string;
797
+ durationMs?: number;
794
798
  executionId: string;
795
- iteration: number;
796
- maxTurns: number;
799
+ failedSteps?: number;
800
+ finalOutput?: string;
801
+ iterations?: number;
802
+ kind: "agent" | "flow";
797
803
  seq: number;
798
- startedAt: string;
804
+ stopReason?: string;
805
+ success: boolean;
806
+ successfulSteps?: number;
799
807
  totalCost?: number;
800
- type: "agent_iteration_start";
801
- } | ({
808
+ totalSteps?: number;
809
+ totalTokens?: {
810
+ input: number;
811
+ output: number;
812
+ };
813
+ type: "execution_complete";
814
+ }) | ({
815
+ code?: string;
816
+ completedAt?: string;
817
+ error: string | {
818
+ code: string;
819
+ details?: Record<string, unknown>;
820
+ message: string;
821
+ };
802
822
  executionId: string;
803
- iteration: number;
804
- role: "user" | "assistant" | "system";
823
+ kind: "agent" | "flow";
805
824
  seq: number;
806
- turnId: string;
807
- turnIndex: number;
808
- type: "agent_turn_start";
825
+ type: "execution_error";
826
+ upgradeUrl?: string;
809
827
  }) | ({
810
- contentType: "text" | "thinking" | "tool_input";
811
- delta: string;
812
828
  executionId: string;
813
- iteration: number;
829
+ id: string;
830
+ iteration?: number;
831
+ role: "user" | "assistant" | "system";
814
832
  seq: number;
815
- turnId: string;
816
- type: "agent_turn_delta";
833
+ turnIndex?: number;
834
+ type: "turn_start";
817
835
  }) | ({
818
- completedAt: string;
836
+ completedAt?: string;
819
837
  content?: string;
820
838
  cost?: number;
821
- estimatedContextBreakdown?: {
822
- categories: Record<string, {
823
- chars: number;
824
- estimatedTokens: number;
839
+ executionId: string;
840
+ fallback?: {
841
+ attempts: Array<{
842
+ attempt: number;
843
+ error?: string;
844
+ model?: string;
845
+ success: boolean;
846
+ type: "retry" | "model" | "message" | "flow";
825
847
  }>;
826
- contextWindowSize?: number;
827
- estimatedTotalTokens: number;
828
- estimatedUtilizationPercent?: number;
848
+ exhausted: boolean;
849
+ model?: string;
850
+ reason?: string | null;
851
+ used: boolean;
829
852
  };
830
- executionId: string;
831
- iteration: number;
853
+ id: string;
854
+ iteration?: number;
832
855
  role: "user" | "assistant" | "system";
833
856
  seq: number;
834
857
  stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
@@ -836,761 +859,262 @@ type RuntypeAgentSSEEvent = {
836
859
  input: number;
837
860
  output: number;
838
861
  };
839
- turnId: string;
840
- type: "agent_turn_complete";
841
- }) | ({
862
+ type: "turn_complete";
863
+ }) | {
842
864
  executionId: string;
843
- iteration: number;
844
- origin?: "webmcp" | "sdk";
845
- pageOrigin?: string;
846
- parameters?: Record<string, unknown>;
865
+ id: string;
866
+ index?: number;
867
+ name?: string;
868
+ outputVariable?: string;
847
869
  seq: number;
848
- toolCallId: string;
849
- toolName: string;
850
- toolType: "flow" | "mcp" | "builtin" | "custom" | "external" | "advisor" | "subagent" | "local";
851
- type: "agent_tool_start";
870
+ startedAt?: string;
871
+ stepType?: string;
872
+ totalSteps?: number;
873
+ type: "step_start";
874
+ } | ({
875
+ completedAt?: string;
876
+ durationMs?: number;
877
+ error?: string;
878
+ executionId: string;
879
+ fallback?: {
880
+ attempts: Array<{
881
+ attempt: number;
882
+ error?: string;
883
+ model?: string;
884
+ success: boolean;
885
+ type: "retry" | "model" | "message" | "flow";
886
+ }>;
887
+ exhausted: boolean;
888
+ model?: string;
889
+ reason?: string | null;
890
+ used: boolean;
891
+ };
892
+ id: string;
893
+ name?: string;
894
+ result?: unknown;
895
+ seq: number;
896
+ stepType?: string;
897
+ stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
898
+ success?: boolean;
899
+ tokensUsed?: number;
900
+ type: "step_complete";
901
+ unresolvedVariables?: Array<string>;
852
902
  }) | {
853
- delta: string;
854
903
  executionId: string;
855
- iteration: number;
904
+ id: string;
905
+ index?: number;
906
+ name?: string;
856
907
  seq: number;
857
- toolCallId: string;
858
- type: "agent_tool_delta";
859
- } | {
860
- delta: string;
908
+ skippedAt?: string;
909
+ stepType?: string;
910
+ totalSteps?: number;
911
+ type: "step_skip";
912
+ when?: string;
913
+ } | ({
861
914
  executionId: string;
862
- iteration: number;
915
+ id: string;
916
+ parentToolCallId?: string;
917
+ role?: "user" | "assistant" | "system";
863
918
  seq: number;
864
- toolCallId: string;
865
- type: "agent_tool_input_delta";
866
- } | {
919
+ stepId?: string;
920
+ turnId?: string;
921
+ type: "text_start";
922
+ }) | {
923
+ delta: string;
867
924
  executionId: string;
868
- hiddenParameterNames?: Array<string>;
869
- iteration: number;
870
- parameters: Record<string, unknown>;
925
+ id: string;
871
926
  seq: number;
872
- toolCallId: string;
873
- toolName: string;
874
- type: "agent_tool_input_complete";
927
+ type: "text_delta";
875
928
  } | {
876
929
  executionId: string;
877
- executionTime?: number;
878
- iteration: number;
879
- result?: unknown;
930
+ id: string;
880
931
  seq: number;
881
- success: boolean;
882
- toolCallId: string;
883
- toolName: string;
884
- type: "agent_tool_complete";
932
+ text?: string;
933
+ type: "text_complete";
885
934
  } | ({
886
- executionId?: string;
887
- iteration: number;
888
- media: Array<({
889
- annotations?: {
890
- audience?: Array<"user" | "assistant">;
891
- };
892
- data: string;
893
- mediaType: string;
894
- type: "media";
895
- }) | ({
896
- annotations?: {
897
- audience?: Array<"user" | "assistant">;
898
- };
899
- mediaType?: string;
900
- type: "image-url";
901
- url: string;
902
- }) | ({
903
- annotations?: {
904
- audience?: Array<"user" | "assistant">;
905
- };
906
- mediaType: string;
907
- type: "file-url";
908
- url: string;
909
- })>;
910
- seq?: number;
911
- toolCallId: string;
912
- toolName: string;
913
- type: "agent_media";
935
+ executionId: string;
936
+ id: string;
937
+ parentToolCallId?: string;
938
+ scope?: "turn" | "loop";
939
+ seq: number;
940
+ type: "reasoning_start";
914
941
  }) | {
915
- approvalId: string;
916
- description: string;
942
+ delta: string;
917
943
  executionId: string;
918
- externalAgent?: {
919
- contextId?: string;
920
- taskId?: string;
921
- };
922
- iteration?: number;
923
- parameters?: Record<string, unknown>;
924
- reason?: string;
944
+ id: string;
925
945
  seq: number;
926
- startedAt: string;
927
- timeout: number;
928
- toolCallId: string;
929
- toolName: string;
930
- toolType: string;
931
- type: "agent_approval_start";
946
+ type: "reasoning_delta";
932
947
  } | ({
933
- approvalId: string;
934
- completedAt: string;
935
- decision: "approved" | "denied" | "timeout";
936
948
  executionId: string;
937
- resolvedBy: "user" | "system";
949
+ id: string;
950
+ scope?: "turn" | "loop";
938
951
  seq: number;
939
- type: "agent_approval_complete";
952
+ text?: string;
953
+ type: "reasoning_complete";
940
954
  }) | ({
941
- awaitedAt: string;
942
955
  executionId: string;
943
- origin?: "webmcp" | "sdk";
944
- pageOrigin?: string;
945
- parameters?: Record<string, unknown>;
956
+ id: string;
957
+ mediaType: string;
958
+ role?: "user" | "assistant" | "system";
946
959
  seq: number;
947
960
  toolCallId?: string;
948
- toolId: string;
949
- toolName: string;
950
- type: "agent_await";
961
+ type: "media_start";
951
962
  }) | {
952
- completedAt: string;
953
- cost?: number;
954
- duration?: number;
955
- estimatedContextBreakdown?: {
956
- categories: Record<string, {
957
- chars: number;
958
- estimatedTokens: number;
959
- }>;
960
- contextWindowSize?: number;
961
- estimatedTotalTokens: number;
962
- estimatedUtilizationPercent?: number;
963
- };
963
+ delta: string;
964
964
  executionId: string;
965
- iteration: number;
966
- output?: string;
967
- runningTotalCost?: number;
965
+ id: string;
968
966
  seq: number;
969
- stopConditionMet: boolean;
970
- tokens?: {
971
- input: number;
972
- output: number;
973
- };
974
- toolCallsMade: number;
975
- type: "agent_iteration_complete";
967
+ type: "media_delta";
976
968
  } | {
969
+ data?: string;
977
970
  executionId: string;
978
- iteration: number;
979
- reflection?: string;
971
+ id: string;
972
+ mediaType?: string;
980
973
  seq: number;
981
- timestamp?: string;
982
- type: "agent_reflection";
974
+ toolCallId?: string;
975
+ type: "media_complete";
976
+ url?: string;
977
+ } | ({
978
+ artifactType: "markdown" | "component";
979
+ component?: string;
980
+ executionId?: string;
981
+ id: string;
982
+ seq?: number;
983
+ title?: string;
984
+ type: "artifact_start";
985
+ }) | {
986
+ delta: string;
987
+ executionId?: string;
988
+ id: string;
989
+ seq?: number;
990
+ type: "artifact_delta";
991
+ } | {
992
+ component: string;
993
+ executionId?: string;
994
+ id: string;
995
+ props: Record<string, unknown>;
996
+ seq?: number;
997
+ type: "artifact_update";
998
+ } | {
999
+ executionId?: string;
1000
+ id: string;
1001
+ seq?: number;
1002
+ type: "artifact_complete";
983
1003
  } | {
984
- activatedCapabilities: Array<string>;
985
1004
  executionId: string;
986
- iteration: number;
1005
+ id?: string;
987
1006
  seq: number;
988
- skill: string;
989
- timestamp?: string;
990
- toolCallId: string;
991
- type: "agent_skill_loaded";
1007
+ sourceType?: string;
1008
+ title?: string;
1009
+ type: "source";
1010
+ url?: string;
1011
+ [key: string]: unknown;
992
1012
  } | ({
993
1013
  executionId: string;
994
- iteration: number;
995
- outcome: "pending_approval" | "auto_published";
996
- proposalId?: string;
1014
+ hiddenParameterNames?: Array<string>;
1015
+ iteration?: number;
1016
+ origin?: "webmcp" | "sdk";
1017
+ pageOrigin?: string;
1018
+ parameters?: Record<string, unknown>;
997
1019
  seq: number;
998
- skill: string;
999
- timestamp?: string;
1020
+ startedAt?: string;
1021
+ stepId?: string;
1000
1022
  toolCallId: string;
1001
- type: "agent_skill_proposed";
1002
- }) | ({
1003
- agentId: string;
1004
- completedAt: string;
1005
- duration?: number;
1006
- error?: string;
1023
+ toolName: string;
1024
+ toolType: string;
1025
+ type: "tool_start";
1026
+ }) | {
1027
+ delta: string;
1007
1028
  executionId: string;
1008
- externalAgent?: {
1009
- contextId?: string;
1010
- taskId?: string;
1011
- };
1012
- finalOutput?: string;
1013
- iterations: number;
1014
1029
  seq: number;
1015
- stopReason: "complete" | "end_turn" | "max_turns" | "max_cost" | "timeout" | "error";
1016
- success: boolean;
1017
- totalCost?: number;
1018
- totalTokens?: {
1019
- input: number;
1020
- output: number;
1021
- };
1022
- type: "agent_complete";
1023
- }) | {
1024
- error: {
1025
- code: string;
1026
- details?: Record<string, unknown>;
1027
- message: string;
1028
- };
1030
+ toolCallId: string;
1031
+ type: "tool_input_delta";
1032
+ } | {
1029
1033
  executionId: string;
1030
- iteration?: number;
1031
- recoverable: boolean;
1034
+ hiddenParameterNames?: Array<string>;
1035
+ parameters: Record<string, unknown>;
1032
1036
  seq: number;
1033
- timestamp?: string;
1034
- type: "agent_error";
1037
+ toolCallId: string;
1038
+ toolName?: string;
1039
+ type: "tool_input_complete";
1035
1040
  } | {
1041
+ delta: string;
1036
1042
  executionId: string;
1037
1043
  seq: number;
1038
- timestamp: string;
1039
- type: "agent_ping";
1040
- };
1041
- type RuntypeFlowSSEEvent = {
1042
- executionContext?: Record<string, unknown>;
1043
- executionId?: string;
1044
- flowId: string;
1045
- flowName?: string;
1046
- input?: unknown;
1047
- seq?: number;
1048
- source?: string;
1049
- startedAt: string;
1050
- toolContext?: {
1051
- executionId: string;
1052
- stepId: string;
1053
- toolId: string;
1054
- };
1055
- totalSteps?: number;
1056
- type: "flow_start";
1044
+ toolCallId: string;
1045
+ type: "tool_output_delta";
1057
1046
  } | {
1058
- claudeManagedAgentId?: string;
1059
- completedAt?: string;
1060
- completedSteps?: number;
1061
- duration?: number;
1062
- executionContext?: Record<string, unknown>;
1063
- executionId?: string;
1064
- executionTime?: number;
1065
- failedSteps?: number;
1066
- finalOutput?: string;
1067
- flowId?: string;
1068
- flowName?: string;
1069
- output?: unknown;
1070
- seq?: number;
1071
- source?: string;
1072
- success?: boolean;
1073
- successfulSteps?: number;
1074
- toolContext?: {
1075
- executionId: string;
1076
- stepId: string;
1077
- toolId: string;
1078
- };
1079
- totalSteps?: number;
1080
- totalTokensUsed?: number;
1081
- type: "flow_complete";
1082
- } | ({
1083
- code?: string;
1084
- error: string | {
1085
- code: string;
1086
- message: string;
1087
- stepId?: string;
1088
- stepType?: string;
1089
- };
1090
- executionId?: string;
1091
- executionTime?: number;
1092
- flowId?: string;
1093
- seq?: number;
1094
- timestamp?: string;
1095
- toolContext?: {
1096
- executionId: string;
1097
- stepId: string;
1098
- toolId: string;
1099
- };
1100
- type: "flow_error";
1101
- upgradeUrl?: string;
1102
- }) | ({
1103
- awaitedAt: string;
1104
- executionId?: string;
1105
- flowId: string;
1106
- origin?: "webmcp" | "sdk";
1107
- pageOrigin?: string;
1108
- parameters?: Record<string, unknown>;
1109
- seq?: number;
1110
- toolCallId?: string;
1111
- toolId?: string;
1112
- toolName?: string;
1113
- type: "flow_await";
1114
- }) | {
1115
- estimatedTokens?: number;
1116
- executionId?: string;
1117
- id?: string;
1118
- index?: number;
1119
- name?: string;
1120
- outputVariable?: string;
1121
- seq?: number;
1122
- startedAt: string;
1123
- stepId?: string;
1124
- stepName?: string;
1125
- stepType?: string;
1126
- toolContext?: {
1127
- executionId: string;
1128
- stepId: string;
1129
- toolId: string;
1130
- };
1131
- totalSteps?: number;
1132
- type: "step_start";
1133
- } | {
1134
- delta?: string;
1135
- executionId?: string;
1136
- id?: string;
1137
- messageId?: string;
1138
- partId?: string;
1139
- seq?: number;
1140
- text?: string;
1141
- toolContext?: {
1142
- executionId: string;
1143
- stepId: string;
1144
- toolId: string;
1145
- };
1146
- toolId?: string;
1147
- type: "step_delta";
1148
- } | ({
1149
- completedAt?: string;
1150
- duration?: number;
1151
- durationMs?: number;
1152
1047
  error?: string;
1153
- executionId?: string;
1154
- executionTime?: number;
1155
- id?: string;
1156
- index?: number;
1157
- name?: string;
1158
- output?: unknown;
1159
- result?: unknown;
1160
- seq?: number;
1161
- stepId?: string;
1162
- stepName?: string;
1163
- stepType?: string;
1164
- stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
1165
- success?: boolean;
1166
- tokensUsed?: number;
1167
- toolContext?: {
1168
- executionId: string;
1169
- stepId: string;
1170
- toolId: string;
1171
- };
1172
- type: "step_complete";
1173
- unresolvedVariables?: Array<string>;
1174
- }) | {
1175
- error: string;
1176
- executionId?: string;
1177
- executionTime?: number;
1178
- id?: string;
1179
- index?: number;
1180
- name?: string;
1181
- seq?: number;
1182
- stepType?: string;
1183
- type: "step_error";
1184
- } | {
1185
- error?: string;
1186
- executionId?: string;
1187
- id: string;
1188
- index?: number;
1189
- name?: string;
1190
- seq?: number;
1191
- skippedAt: string;
1192
- stepType: string;
1193
- totalSteps: number;
1194
- type: "step_skip";
1195
- when: string;
1196
- } | {
1197
- executionId?: string;
1198
- reason?: string;
1199
- seq?: number;
1200
- type: "step_await";
1201
- [key: string]: unknown;
1202
- } | ({
1203
- agentContext?: {
1204
- executionId: string;
1205
- iteration: number;
1206
- seq: number;
1207
- };
1208
- executionId?: string;
1209
- hiddenParameterNames?: Array<string>;
1210
- name?: string;
1211
- parameters?: Record<string, unknown>;
1212
- providerOptions?: Record<string, unknown>;
1213
- seq?: number;
1214
- startedAt?: string;
1215
- stepId?: string;
1216
- toolCallId?: string;
1217
- toolId?: string;
1218
- toolName?: string;
1219
- toolType: "flow" | "mcp" | "builtin" | "custom" | "external" | "advisor" | "subagent" | "local";
1220
- type: "tool_start";
1221
- [key: string]: unknown;
1222
- }) | {
1223
- delta?: string;
1224
- executionId?: string;
1225
- seq?: number;
1226
- toolId?: string;
1227
- type: "tool_delta";
1228
- [key: string]: unknown;
1229
- } | {
1230
- delta: string;
1231
- executionId?: string;
1232
- seq?: number;
1233
- stepId?: string;
1234
- toolCallId?: string;
1235
- toolId?: string;
1236
- type: "tool_input_delta";
1237
- } | {
1238
- executionId?: string;
1239
- hiddenParameterNames?: Array<string>;
1240
- parameters: Record<string, unknown>;
1241
- providerOptions?: Record<string, unknown>;
1242
- seq?: number;
1243
- stepId?: string;
1244
- toolCallId?: string;
1245
- toolId?: string;
1246
- toolName?: string;
1247
- type: "tool_input_complete";
1248
- } | {
1249
- agentContext?: {
1250
- executionId: string;
1251
- iteration: number;
1252
- seq: number;
1253
- };
1254
- completedAt?: string;
1255
- error?: string;
1256
- executionId?: string;
1257
- executionTime?: number;
1258
- name?: string;
1259
- result?: unknown;
1260
- seq?: number;
1261
- stepId?: string;
1262
- success: boolean;
1263
- toolCallId?: string;
1264
- toolCost?: number;
1265
- toolId?: string;
1266
- toolName?: string;
1267
- type: "tool_complete";
1268
- } | {
1269
- agentContext?: {
1270
- executionId: string;
1271
- iteration: number;
1272
- seq: number;
1273
- };
1274
- error: string;
1275
- executionId?: string;
1276
- executionTime?: number;
1277
- failedAt?: string;
1278
- name: string;
1279
- seq?: number;
1280
- toolId: string;
1281
- type: "tool_error";
1282
- } | {
1283
- executionId?: string;
1284
- id: string;
1285
- seq?: number;
1286
- text: string;
1287
- type: "chunk";
1288
- } | {
1289
- executionId?: string;
1290
- seq?: number;
1291
- type: "text_start";
1292
- [key: string]: unknown;
1293
- } | {
1294
- executionId?: string;
1295
- seq?: number;
1296
- type: "text_end";
1297
- [key: string]: unknown;
1298
- } | {
1299
- executionId?: string;
1300
- seq?: number;
1301
- type: "reason_start";
1302
- [key: string]: unknown;
1303
- } | {
1304
- executionId?: string;
1305
- seq?: number;
1306
- type: "reason_delta";
1307
- [key: string]: unknown;
1308
- } | {
1309
- executionId?: string;
1310
- seq?: number;
1311
- type: "reason_complete";
1312
- [key: string]: unknown;
1313
- } | {
1314
- executionId?: string;
1315
- seq?: number;
1316
- type: "source";
1317
- [key: string]: unknown;
1318
- } | {
1319
- executionId?: string;
1320
- seq?: number;
1321
- type: "fallback_start";
1322
- [key: string]: unknown;
1323
- } | {
1324
- executionId?: string;
1325
- seq?: number;
1326
- type: "fallback_complete";
1327
- [key: string]: unknown;
1328
- } | {
1329
- executionId?: string;
1330
- seq?: number;
1331
- type: "fallback_exhausted";
1332
- [key: string]: unknown;
1333
- };
1334
- type RuntypeDispatchSSEEvent = {
1335
- agentId: string;
1336
- agentName: string;
1337
- config?: {
1338
- enableReflection?: boolean;
1339
- model?: string;
1340
- };
1341
- executionId: string;
1342
- maxTurns: number;
1343
- seq: number;
1344
- startedAt: string;
1345
- type: "agent_start";
1346
- } | {
1347
- executionId: string;
1348
- iteration: number;
1349
- maxTurns: number;
1350
- seq: number;
1351
- startedAt: string;
1352
- totalCost?: number;
1353
- type: "agent_iteration_start";
1354
- } | ({
1355
- executionId: string;
1356
- iteration: number;
1357
- role: "user" | "assistant" | "system";
1358
- seq: number;
1359
- turnId: string;
1360
- turnIndex: number;
1361
- type: "agent_turn_start";
1362
- }) | ({
1363
- contentType: "text" | "thinking" | "tool_input";
1364
- delta: string;
1365
- executionId: string;
1366
- iteration: number;
1367
- seq: number;
1368
- turnId: string;
1369
- type: "agent_turn_delta";
1370
- }) | ({
1371
- completedAt: string;
1372
- content?: string;
1373
- cost?: number;
1374
- estimatedContextBreakdown?: {
1375
- categories: Record<string, {
1376
- chars: number;
1377
- estimatedTokens: number;
1378
- }>;
1379
- contextWindowSize?: number;
1380
- estimatedTotalTokens: number;
1381
- estimatedUtilizationPercent?: number;
1382
- };
1383
- executionId: string;
1384
- iteration: number;
1385
- role: "user" | "assistant" | "system";
1386
- seq: number;
1387
- stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
1388
- tokens?: {
1389
- input: number;
1390
- output: number;
1391
- };
1392
- turnId: string;
1393
- type: "agent_turn_complete";
1394
- }) | ({
1395
- executionId: string;
1396
- iteration: number;
1397
- origin?: "webmcp" | "sdk";
1398
- pageOrigin?: string;
1399
- parameters?: Record<string, unknown>;
1400
- seq: number;
1401
- toolCallId: string;
1402
- toolName: string;
1403
- toolType: "flow" | "mcp" | "builtin" | "custom" | "external" | "advisor" | "subagent" | "local";
1404
- type: "agent_tool_start";
1405
- }) | {
1406
- delta: string;
1407
- executionId: string;
1408
- iteration: number;
1409
- seq: number;
1410
- toolCallId: string;
1411
- type: "agent_tool_delta";
1412
- } | {
1413
- delta: string;
1414
- executionId: string;
1415
- iteration: number;
1416
- seq: number;
1417
- toolCallId: string;
1418
- type: "agent_tool_input_delta";
1419
- } | {
1420
- executionId: string;
1421
- hiddenParameterNames?: Array<string>;
1422
- iteration: number;
1423
- parameters: Record<string, unknown>;
1424
- seq: number;
1425
- toolCallId: string;
1426
- toolName: string;
1427
- type: "agent_tool_input_complete";
1428
- } | {
1429
1048
  executionId: string;
1430
1049
  executionTime?: number;
1431
- iteration: number;
1050
+ iteration?: number;
1432
1051
  result?: unknown;
1433
1052
  seq: number;
1053
+ stepId?: string;
1434
1054
  success: boolean;
1435
1055
  toolCallId: string;
1436
- toolName: string;
1437
- type: "agent_tool_complete";
1438
- } | ({
1439
- executionId?: string;
1440
- iteration: number;
1441
- media: Array<({
1442
- annotations?: {
1443
- audience?: Array<"user" | "assistant">;
1444
- };
1445
- data: string;
1446
- mediaType: string;
1447
- type: "media";
1448
- }) | ({
1449
- annotations?: {
1450
- audience?: Array<"user" | "assistant">;
1451
- };
1452
- mediaType?: string;
1453
- type: "image-url";
1454
- url: string;
1455
- }) | ({
1456
- annotations?: {
1457
- audience?: Array<"user" | "assistant">;
1458
- };
1459
- mediaType: string;
1460
- type: "file-url";
1461
- url: string;
1462
- })>;
1463
- seq?: number;
1464
- toolCallId: string;
1465
- toolName: string;
1466
- type: "agent_media";
1467
- }) | {
1056
+ toolName?: string;
1057
+ type: "tool_complete";
1058
+ } | {
1468
1059
  approvalId: string;
1469
- description: string;
1060
+ description?: string;
1470
1061
  executionId: string;
1471
- externalAgent?: {
1472
- contextId?: string;
1473
- taskId?: string;
1474
- };
1475
1062
  iteration?: number;
1476
1063
  parameters?: Record<string, unknown>;
1477
1064
  reason?: string;
1478
1065
  seq: number;
1479
- startedAt: string;
1480
- timeout: number;
1481
- toolCallId: string;
1066
+ startedAt?: string;
1067
+ subagent?: {
1068
+ agentName?: string;
1069
+ toolName: string;
1070
+ };
1071
+ timeout?: number;
1072
+ toolCallId?: string;
1482
1073
  toolName: string;
1483
- toolType: string;
1484
- type: "agent_approval_start";
1074
+ toolType?: string;
1075
+ type: "approval_start";
1485
1076
  } | ({
1486
1077
  approvalId: string;
1487
- completedAt: string;
1078
+ completedAt?: string;
1488
1079
  decision: "approved" | "denied" | "timeout";
1489
1080
  executionId: string;
1490
- resolvedBy: "user" | "system";
1081
+ resolvedBy?: "user" | "system";
1491
1082
  seq: number;
1492
- type: "agent_approval_complete";
1083
+ type: "approval_complete";
1493
1084
  }) | ({
1494
- awaitedAt: string;
1085
+ awaitedAt?: string;
1495
1086
  executionId: string;
1496
1087
  origin?: "webmcp" | "sdk";
1497
1088
  pageOrigin?: string;
1498
1089
  parameters?: Record<string, unknown>;
1499
1090
  seq: number;
1500
1091
  toolCallId?: string;
1501
- toolId: string;
1502
- toolName: string;
1503
- type: "agent_await";
1504
- }) | {
1505
- completedAt: string;
1506
- cost?: number;
1507
- duration?: number;
1508
- estimatedContextBreakdown?: {
1509
- categories: Record<string, {
1510
- chars: number;
1511
- estimatedTokens: number;
1512
- }>;
1513
- contextWindowSize?: number;
1514
- estimatedTotalTokens: number;
1515
- estimatedUtilizationPercent?: number;
1516
- };
1517
- executionId: string;
1518
- iteration: number;
1519
- output?: string;
1520
- runningTotalCost?: number;
1521
- seq: number;
1522
- stopConditionMet: boolean;
1523
- tokens?: {
1524
- input: number;
1525
- output: number;
1526
- };
1527
- toolCallsMade: number;
1528
- type: "agent_iteration_complete";
1529
- } | {
1530
- executionId: string;
1531
- iteration: number;
1532
- reflection?: string;
1533
- seq: number;
1534
- timestamp?: string;
1535
- type: "agent_reflection";
1536
- } | {
1537
- activatedCapabilities: Array<string>;
1538
- executionId: string;
1539
- iteration: number;
1540
- seq: number;
1541
- skill: string;
1542
- timestamp?: string;
1543
- toolCallId: string;
1544
- type: "agent_skill_loaded";
1545
- } | ({
1546
- executionId: string;
1547
- iteration: number;
1548
- outcome: "pending_approval" | "auto_published";
1549
- proposalId?: string;
1550
- seq: number;
1551
- skill: string;
1552
- timestamp?: string;
1553
- toolCallId: string;
1554
- type: "agent_skill_proposed";
1092
+ toolId?: string;
1093
+ toolName?: string;
1094
+ type: "await";
1555
1095
  }) | ({
1556
- agentId: string;
1557
- completedAt: string;
1558
- duration?: number;
1559
- error?: string;
1560
- executionId: string;
1561
- externalAgent?: {
1562
- contextId?: string;
1563
- taskId?: string;
1564
- };
1565
- finalOutput?: string;
1566
- iterations: number;
1567
- seq: number;
1568
- stopReason: "complete" | "end_turn" | "max_turns" | "max_cost" | "timeout" | "error";
1569
- success: boolean;
1570
- totalCost?: number;
1571
- totalTokens?: {
1572
- input: number;
1573
- output: number;
1574
- };
1575
- type: "agent_complete";
1576
- }) | {
1577
- error: {
1096
+ error: string | {
1578
1097
  code: string;
1579
1098
  details?: Record<string, unknown>;
1580
1099
  message: string;
1581
1100
  };
1582
1101
  executionId: string;
1583
- iteration?: number;
1584
- recoverable: boolean;
1102
+ recoverable?: boolean;
1585
1103
  seq: number;
1586
- timestamp?: string;
1587
- type: "agent_error";
1588
- } | {
1104
+ type: "error";
1105
+ }) | {
1589
1106
  executionId: string;
1590
1107
  seq: number;
1591
1108
  timestamp: string;
1592
- type: "agent_ping";
1109
+ type: "ping";
1593
1110
  } | {
1111
+ executionId?: string;
1112
+ name: string;
1113
+ seq?: number;
1114
+ type: "custom";
1115
+ value?: unknown;
1116
+ };
1117
+ type RuntypeFlowSSEEvent = {
1594
1118
  executionContext?: Record<string, unknown>;
1595
1119
  executionId?: string;
1596
1120
  flowId: string;
@@ -1882,40 +1406,13 @@ type RuntypeDispatchSSEEvent = {
1882
1406
  seq?: number;
1883
1407
  type: "fallback_exhausted";
1884
1408
  [key: string]: unknown;
1885
- } | ({
1886
- artifactType: "markdown" | "component";
1887
- component?: string;
1888
- id: string;
1889
- title?: string;
1890
- type: "artifact_start";
1891
- }) | {
1892
- delta: string;
1893
- id: string;
1894
- type: "artifact_delta";
1895
- } | {
1896
- component: string;
1897
- id: string;
1898
- props: Record<string, unknown>;
1899
- type: "artifact_update";
1900
- } | {
1901
- id: string;
1902
- type: "artifact_complete";
1903
- } | ({
1904
- artifactType?: "markdown" | "component";
1905
- component?: string;
1906
- content?: string;
1907
- id?: string;
1908
- props?: Record<string, unknown>;
1909
- title?: string;
1910
- type: "artifact";
1911
- [key: string]: unknown;
1912
- });
1409
+ };
1913
1410
  type RuntypeStreamEventOf<U, T extends string> = Extract<U, {
1914
1411
  type: T;
1915
1412
  }>;
1916
- type RuntypeAgentTurnCompleteEvent = RuntypeStreamEventOf<RuntypeAgentSSEEvent, "agent_turn_complete">;
1413
+ type RuntypeTurnCompleteEvent = RuntypeStreamEventOf<RuntypeExecutionStreamEvent, "turn_complete">;
1917
1414
  type RuntypeStepCompleteEvent = RuntypeStreamEventOf<RuntypeFlowSSEEvent, "step_complete">;
1918
- type RuntypeStopReasonKind = NonNullable<RuntypeAgentTurnCompleteEvent["stopReason"] | RuntypeStepCompleteEvent["stopReason"]>;
1415
+ type RuntypeStopReasonKind = NonNullable<RuntypeTurnCompleteEvent["stopReason"] | RuntypeStepCompleteEvent["stopReason"]>;
1919
1416
  type RuntypeClientInitRequest = {
1920
1417
  flowId?: string;
1921
1418
  sessionId?: string;
@@ -1946,6 +1443,7 @@ type RuntypeClientChatRequest = {
1946
1443
  type: "object";
1947
1444
  [key: string]: unknown;
1948
1445
  };
1446
+ untrustedContentHint?: boolean;
1949
1447
  }>;
1950
1448
  clientToolsFingerprint?: string;
1951
1449
  inputs?: Record<string, unknown>;
@@ -1975,7 +1473,7 @@ type RuntypeClientChatRequest = {
1975
1473
  submitMode?: "normal" | "interrupt";
1976
1474
  turnId?: string;
1977
1475
  };
1978
- type RuntypeClientChatStreamEvent = RuntypeFlowSSEEvent;
1476
+ type RuntypeClientChatStreamEvent = RuntypeExecutionStreamEvent;
1979
1477
  type RuntypeClientResumeRequest = {
1980
1478
  executionId: string;
1981
1479
  messages?: Array<{
@@ -2002,7 +1500,7 @@ type RuntypeClientResumeRequest = {
2002
1500
  streamResponse?: boolean;
2003
1501
  toolOutputs?: Record<string, unknown>;
2004
1502
  };
2005
- type RuntypeClientResumeStreamEvent = RuntypeDispatchSSEEvent;
1503
+ type RuntypeClientResumeStreamEvent = RuntypeExecutionStreamEvent;
2006
1504
  type RuntypeClientFeedbackRequest = {
2007
1505
  comment?: string;
2008
1506
  messageId?: string;
@@ -5363,6 +4861,11 @@ type AgentWidgetConfig = {
5363
4861
  * When provided, the widget uses agent loop execution instead of flow dispatch.
5364
4862
  * Mutually exclusive with `flowId`.
5365
4863
  *
4864
+ * Note: `@runtypelabs/persona-proxy` rejects a client-supplied `agent` (it was
4865
+ * an open relay). This option is only for endpoints authorized to accept a
4866
+ * client agent — your own backend, or token-scoped direct-to-Runtype dispatch.
4867
+ * For the proxy, pin the agent server-side with `agentConfig`/`agentId`.
4868
+ *
5366
4869
  * @example
5367
4870
  * ```typescript
5368
4871
  * config: {
@@ -6012,6 +5515,12 @@ type AgentWidgetReasoning = {
6012
5515
  id: string;
6013
5516
  status: "pending" | "streaming" | "complete";
6014
5517
  chunks: string[];
5518
+ /**
5519
+ * Reasoning channel scope (unified spec). `"turn"` is ordinary per-turn
5520
+ * thinking; `"loop"` is a cross-iteration agent reflection (the fold that
5521
+ * replaced the legacy `agent_reflection` event). Absent for legacy streams.
5522
+ */
5523
+ scope?: "turn" | "loop";
6015
5524
  startedAt?: number;
6016
5525
  completedAt?: number;
6017
5526
  durationMs?: number;
@@ -6370,8 +5879,6 @@ type AgentWidgetInitOptions = {
6370
5879
  useShadowDom?: boolean;
6371
5880
  /** Fired when the widget controller is mounted and its API is callable. */
6372
5881
  onChatReady?: () => void;
6373
- /** @deprecated Use `onChatReady`. Retained as an alias; removed in the next major. */
6374
- onReady?: () => void;
6375
5882
  windowKey?: string;
6376
5883
  debugTools?: boolean;
6377
5884
  };
@@ -7196,6 +6703,83 @@ declare class AgentWidgetSession {
7196
6703
  private sortMessages;
7197
6704
  }
7198
6705
 
6706
+ type LoadingIndicatorRenderer = (context: LoadingIndicatorRenderContext) => HTMLElement | null;
6707
+ type MessageTransform = (context: {
6708
+ text: string;
6709
+ message: AgentWidgetMessage;
6710
+ streaming: boolean;
6711
+ raw?: string;
6712
+ }) => string;
6713
+ type MessageActionCallbacks = {
6714
+ onCopy?: (message: AgentWidgetMessage) => void;
6715
+ onFeedback?: (feedback: AgentWidgetMessageFeedback) => void;
6716
+ };
6717
+ declare const createTypingIndicator: () => HTMLElement;
6718
+ /**
6719
+ * Render loading indicator with fallback chain:
6720
+ * 1. Custom renderer (if provided and returns non-null)
6721
+ * 2. Default typing indicator
6722
+ */
6723
+ declare const renderLoadingIndicatorWithFallback: (location: "inline" | "standalone", customRenderer?: LoadingIndicatorRenderer, widgetConfig?: AgentWidgetConfig) => HTMLElement | null;
6724
+ /**
6725
+ * Create message action buttons (copy, upvote, downvote)
6726
+ *
6727
+ * This is a pure rendering function. It creates button elements with the
6728
+ * correct `data-action` attributes, icons, and CSS classes. All click
6729
+ * handling, vote state management, clipboard logic, and callback dispatch
6730
+ * is handled via event delegation in `ui.ts` so that handlers survive
6731
+ * idiomorph DOM morphing.
6732
+ */
6733
+ declare const createMessageActions: (message: AgentWidgetMessage, actionsConfig: AgentWidgetMessageActionsConfig, _callbacks?: MessageActionCallbacks) => HTMLElement;
6734
+ /**
6735
+ * Options for creating a standard message bubble
6736
+ */
6737
+ type CreateStandardBubbleOptions = {
6738
+ /**
6739
+ * Custom loading indicator renderer for inline location
6740
+ */
6741
+ loadingIndicatorRenderer?: LoadingIndicatorRenderer;
6742
+ /**
6743
+ * Full widget config (needed for loading indicator context)
6744
+ */
6745
+ widgetConfig?: AgentWidgetConfig;
6746
+ };
6747
+ /**
6748
+ * Create standard message bubble
6749
+ * Supports layout configuration for avatars, timestamps, and visual presets
6750
+ */
6751
+ declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
6752
+ /**
6753
+ * Create bubble with custom renderer support
6754
+ * Uses custom renderer if provided in layout config, otherwise falls back to standard bubble
6755
+ */
6756
+ declare const createBubbleWithLayout: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
6757
+
6758
+ type ActionManagerProcessContext = {
6759
+ text: string;
6760
+ message: AgentWidgetMessage;
6761
+ streaming: boolean;
6762
+ raw?: string;
6763
+ };
6764
+ type ActionManagerOptions = {
6765
+ parsers: AgentWidgetActionParser[];
6766
+ handlers: AgentWidgetActionHandler[];
6767
+ getSessionMetadata: () => Record<string, unknown>;
6768
+ updateSessionMetadata: (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
6769
+ emit: <K extends keyof AgentWidgetControllerEventMap>(event: K, payload: AgentWidgetControllerEventMap[K]) => void;
6770
+ documentRef: Document | null;
6771
+ };
6772
+ declare const defaultJsonActionParser: AgentWidgetActionParser;
6773
+ declare const defaultActionHandlers: Record<string, AgentWidgetActionHandler>;
6774
+ declare const createActionManager: (options: ActionManagerOptions) => {
6775
+ process: (context: ActionManagerProcessContext) => {
6776
+ text: string;
6777
+ persist: boolean;
6778
+ resubmit?: boolean;
6779
+ } | null;
6780
+ syncFromMetadata: () => void;
6781
+ };
6782
+
7199
6783
  /**
7200
6784
  * Feedback UI components for CSAT and NPS collection
7201
6785
  */
@@ -7711,31 +7295,6 @@ declare const isWebMcpToolName: (name: string) => boolean;
7711
7295
 
7712
7296
  declare const createLocalStorageAdapter: (key?: string) => AgentWidgetStorageAdapter;
7713
7297
 
7714
- type ActionManagerProcessContext = {
7715
- text: string;
7716
- message: AgentWidgetMessage;
7717
- streaming: boolean;
7718
- raw?: string;
7719
- };
7720
- type ActionManagerOptions = {
7721
- parsers: AgentWidgetActionParser[];
7722
- handlers: AgentWidgetActionHandler[];
7723
- getSessionMetadata: () => Record<string, unknown>;
7724
- updateSessionMetadata: (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
7725
- emit: <K extends keyof AgentWidgetControllerEventMap>(event: K, payload: AgentWidgetControllerEventMap[K]) => void;
7726
- documentRef: Document | null;
7727
- };
7728
- declare const defaultJsonActionParser: AgentWidgetActionParser;
7729
- declare const defaultActionHandlers: Record<string, AgentWidgetActionHandler>;
7730
- declare const createActionManager: (options: ActionManagerOptions) => {
7731
- process: (context: ActionManagerProcessContext) => {
7732
- text: string;
7733
- persist: boolean;
7734
- resubmit?: boolean;
7735
- } | null;
7736
- syncFromMetadata: () => void;
7737
- };
7738
-
7739
7298
  /**
7740
7299
  * Options for creating a markdown processor
7741
7300
  */
@@ -8896,58 +8455,6 @@ declare function createComponentStreamParser(): {
8896
8455
  */
8897
8456
  declare function isComponentDirectiveType(obj: unknown): obj is ComponentDirective;
8898
8457
 
8899
- type LoadingIndicatorRenderer = (context: LoadingIndicatorRenderContext) => HTMLElement | null;
8900
- type MessageTransform = (context: {
8901
- text: string;
8902
- message: AgentWidgetMessage;
8903
- streaming: boolean;
8904
- raw?: string;
8905
- }) => string;
8906
- type MessageActionCallbacks = {
8907
- onCopy?: (message: AgentWidgetMessage) => void;
8908
- onFeedback?: (feedback: AgentWidgetMessageFeedback) => void;
8909
- };
8910
- declare const createTypingIndicator: () => HTMLElement;
8911
- /**
8912
- * Render loading indicator with fallback chain:
8913
- * 1. Custom renderer (if provided and returns non-null)
8914
- * 2. Default typing indicator
8915
- */
8916
- declare const renderLoadingIndicatorWithFallback: (location: "inline" | "standalone", customRenderer?: LoadingIndicatorRenderer, widgetConfig?: AgentWidgetConfig) => HTMLElement | null;
8917
- /**
8918
- * Create message action buttons (copy, upvote, downvote)
8919
- *
8920
- * This is a pure rendering function. It creates button elements with the
8921
- * correct `data-action` attributes, icons, and CSS classes. All click
8922
- * handling, vote state management, clipboard logic, and callback dispatch
8923
- * is handled via event delegation in `ui.ts` so that handlers survive
8924
- * idiomorph DOM morphing.
8925
- */
8926
- declare const createMessageActions: (message: AgentWidgetMessage, actionsConfig: AgentWidgetMessageActionsConfig, _callbacks?: MessageActionCallbacks) => HTMLElement;
8927
- /**
8928
- * Options for creating a standard message bubble
8929
- */
8930
- type CreateStandardBubbleOptions = {
8931
- /**
8932
- * Custom loading indicator renderer for inline location
8933
- */
8934
- loadingIndicatorRenderer?: LoadingIndicatorRenderer;
8935
- /**
8936
- * Full widget config (needed for loading indicator context)
8937
- */
8938
- widgetConfig?: AgentWidgetConfig;
8939
- };
8940
- /**
8941
- * Create standard message bubble
8942
- * Supports layout configuration for avatars, timestamps, and visual presets
8943
- */
8944
- declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
8945
- /**
8946
- * Create bubble with custom renderer support
8947
- * Uses custom renderer if provided in layout config, otherwise falls back to standard bubble
8948
- */
8949
- declare const createBubbleWithLayout: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
8950
-
8951
8458
  /**
8952
8459
  * Options for component middleware
8953
8460
  */
@@ -9339,4 +8846,4 @@ interface DemoCarouselHandle {
9339
8846
  }
9340
8847
  declare function createDemoCarousel(container: HTMLElement, options: DemoCarouselOptions): DemoCarouselHandle;
9341
8848
 
9342
- export { ASK_USER_QUESTION_CLIENT_TOOL, ASK_USER_QUESTION_PARAMETERS_SCHEMA, ASK_USER_QUESTION_TOOL_NAME, type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentToolsConfig, type AgentWidgetActionContext, type AgentWidgetActionEventPayload, type AgentWidgetActionHandler, type AgentWidgetActionHandlerResult, type AgentWidgetActionParser, type AgentWidgetAgentRequestPayload, type AgentWidgetApproval, type AgentWidgetApprovalConfig, type AgentWidgetApprovalDecisionOptions, type AgentWidgetArtifactsFeature, type AgentWidgetArtifactsLayoutConfig, type AgentWidgetAskUserQuestionFeature, type AgentWidgetAskUserQuestionStyles, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetComposerConfig, type AgentWidgetConfig, type AgentWidgetContextProvider, type AgentWidgetContextProviderContext, type AgentWidgetController, type AgentWidgetControllerEventMap, type AgentWidgetCustomFetch, type AgentWidgetDockConfig, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLayoutConfig, type AgentWidgetLoadingIndicatorConfig, type AgentWidgetMarkdownConfig, type AgentWidgetMarkdownOptions, type AgentWidgetMarkdownRendererOverrides, type AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetParsedAction, type AgentWidgetPlugin, type AgentWidgetReadAloudEvent, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamAnimationBuffer, type AgentWidgetStreamAnimationBuiltinType, type AgentWidgetStreamAnimationFeature, type AgentWidgetStreamAnimationPlaceholder, type AgentWidgetStreamAnimationType, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTimestampConfig, type AgentWidgetVoiceStatusEvent, type AgentWidgetWebMcpConfig, type ArtifactConfigPayload, type ArtifactPaneTokens, type ArtifactTabTokens, type ArtifactToolbarTokens, type AskUserQuestionOption, type AskUserQuestionPayload, type AskUserQuestionPrompt, AttachmentManager, type AttachmentManagerConfig, type BorderScale, BrowserSpeechEngine, type BrowserSpeechEngineOptions, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type ClientToolDefinition, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ColorPalette, type ColorShade, type ComboButtonHandle, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComponentTokens, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateComboButtonOptions, type CreateDropdownOptions, type CreateIconButtonOptions, type CreateLabelButtonOptions, type CreateStandardBubbleOptions, type CreateThemeOptions, type CreateToggleGroupOptions, DEFAULT_COMPONENTS, DEFAULT_FLOATING_LAUNCHER_MAX_WIDTH, DEFAULT_FLOATING_LAUNCHER_WIDTH, DEFAULT_PALETTE, DEFAULT_SEMANTIC, DEFAULT_WIDGET_CONFIG, type DeepPartial, type DemoCarouselHandle, type DemoCarouselItem, type DemoCarouselOptions, type DomContextMode, type DomContextOptions, type DropdownMenuHandle, type DropdownMenuItem, type EnrichedPageElement, type EventStreamBadgeColor, type EventStreamConfig, type EventStreamPayloadRenderContext, type EventStreamRowRenderContext, type EventStreamToolbarRenderContext, type EventStreamViewRenderContext, type FallbackSpeechEngineOptions, type FormatEnrichedContextOptions, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type IconButtonTokens, type IconName, type IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectComponentDirectiveOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LabelButtonTokens, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, PRESETS, PRESET_FULLSCREEN, PRESET_MINIMAL, PRESET_SHOP, type ParseOptionsConfig, type ParseRule, type PcmStreamPlayer, type PendingAttachment, type PersonaArtifactKind, type PersonaArtifactManualUpsert, type PersonaArtifactRecord, type PersonaTheme, type PersonaThemePlugin, type RadiusScale, ReadAloudController, type ReadAloudListener, type ReadAloudState, type RuleScoringContext, type RuntypeAgentSSEEvent, type RuntypeAgentTurnCompleteEvent, type RuntypeClientChatRequest, type RuntypeClientChatStreamEvent, type RuntypeClientFeedbackRequest, type RuntypeClientFeedbackResponse, type RuntypeClientFeedbackType, type RuntypeClientInitRequest, type RuntypeClientInitResponse, type RuntypeClientResumeRequest, type RuntypeClientResumeStreamEvent, type RuntypeDispatchSSEEvent, type RuntypeFlowSSEEvent, type RuntypeStepCompleteEvent, type RuntypeStopReasonKind, type RuntypeStreamEventOf, type SSEEventCallback, type SSEEventRecord, SUGGEST_REPLIES_CLIENT_TOOL, SUGGEST_REPLIES_PARAMETERS_SCHEMA, SUGGEST_REPLIES_TOOL_NAME, type SanitizeFunction, type SemanticColors, type SemanticSpacing, type SemanticTypography, type ShadowScale, type SlotRenderContext, type SlotRenderer, type SpacingScale, type SpeechCallbacks, type SpeechEngine, type SpeechRequest, type StreamAnimationContext, type StreamAnimationPlugin, THEME_ZONES, type TextContentPart, type ThemeValidationError, type ThemeValidationResult, type ThemeZone, type ToggleGroupHandle, type ToggleGroupItem, type ToggleGroupTokens, type TokenReference, type TypographyScale, VERSION, type VoiceConfig, type VoiceMetrics, type VoicePlaybackEngine, type VoiceProvider, type VoiceResult, type VoiceStatus, WEBMCP_TOOL_PREFIX, WebMcpBridge, type WebMcpConfirmHandler, type WebMcpConfirmInfo, type WebMcpToolResult, type WidgetHostLayout, type WidgetHostLayoutMode, type WidgetLayoutSlot, type WidgetPreset, accessibilityPlugin, animationsPlugin, applyThemeVariables, attachHeaderToContainer, brandPlugin, buildComposer, buildDefaultHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, builtInClientToolsForDispatch, collectEnrichedPageContext, componentRegistry, createActionManager, createAgentExperience, createAskUserQuestionBubble, createBestAvailableVoiceProvider, createBubbleWithLayout, createCSATFeedback, createComboButton, createComponentMiddleware, createComponentStreamParser, createDefaultSanitizer, createDemoCarousel, createDirectivePostprocessor, createDropdownMenu, createFlexibleJsonStreamParser, createIconButton, createImagePart, createJsonStreamParser, createLabelButton, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createPlugin, createRegexJsonParser, createStandardBubble, createTextPart, createTheme, createThemeObserver, createToggleGroup, createTypingIndicator, createVoiceProvider, createWidgetHostLayout, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, defaultParseRules, detectColorScheme, directivePostprocessor, ensureAskUserQuestionSheet, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, formatEnrichedContext, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateStableSelector, generateUserMessageId, getActiveTheme, getColorScheme, getDisplayText, getHeaderLayout, getImageParts, getPreset, hasComponentDirective, hasImages, headerLayouts, highContrastPlugin, initAgentWidget, isAskUserQuestionMessage, isComponentDirectiveType, isDockedMountMode, isSuggestRepliesMessage, isVoiceSupported, isWebMcpToolName, latestAgentSuggestions, listRegisteredStreamAnimations, markdownPostprocessor, mergeWithDefaults, normalizeContent, parseAskUserQuestionPayload, parseSuggestRepliesPayload, pickBestVoice, pluginRegistry, reducedMotionPlugin, registerStreamAnimationPlugin, removeAskUserQuestionSheet, renderComponentDirective, renderLoadingIndicatorWithFallback, renderLucideIcon, resolveDockConfig, resolveSanitizer, resolveTokens, stripWebMcpPrefix, themeToCssVariables, unregisterStreamAnimationPlugin, validateImageFile, validateTheme };
8849
+ export { ASK_USER_QUESTION_CLIENT_TOOL, ASK_USER_QUESTION_PARAMETERS_SCHEMA, ASK_USER_QUESTION_TOOL_NAME, type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentToolsConfig, type AgentWidgetActionContext, type AgentWidgetActionEventPayload, type AgentWidgetActionHandler, type AgentWidgetActionHandlerResult, type AgentWidgetActionParser, type AgentWidgetAgentRequestPayload, type AgentWidgetApproval, type AgentWidgetApprovalConfig, type AgentWidgetApprovalDecisionOptions, type AgentWidgetArtifactsFeature, type AgentWidgetArtifactsLayoutConfig, type AgentWidgetAskUserQuestionFeature, type AgentWidgetAskUserQuestionStyles, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetComposerConfig, type AgentWidgetConfig, type AgentWidgetContextProvider, type AgentWidgetContextProviderContext, type AgentWidgetController, type AgentWidgetControllerEventMap, type AgentWidgetCustomFetch, type AgentWidgetDockConfig, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLayoutConfig, type AgentWidgetLoadingIndicatorConfig, type AgentWidgetMarkdownConfig, type AgentWidgetMarkdownOptions, type AgentWidgetMarkdownRendererOverrides, type AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetParsedAction, type AgentWidgetPlugin, type AgentWidgetReadAloudEvent, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamAnimationBuffer, type AgentWidgetStreamAnimationBuiltinType, type AgentWidgetStreamAnimationFeature, type AgentWidgetStreamAnimationPlaceholder, type AgentWidgetStreamAnimationType, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTimestampConfig, type AgentWidgetVoiceStatusEvent, type AgentWidgetWebMcpConfig, type ArtifactConfigPayload, type ArtifactPaneTokens, type ArtifactTabTokens, type ArtifactToolbarTokens, type AskUserQuestionOption, type AskUserQuestionPayload, type AskUserQuestionPrompt, AttachmentManager, type AttachmentManagerConfig, type BorderScale, BrowserSpeechEngine, type BrowserSpeechEngineOptions, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type ClientToolDefinition, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ColorPalette, type ColorShade, type ComboButtonHandle, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComponentTokens, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateComboButtonOptions, type CreateDropdownOptions, type CreateIconButtonOptions, type CreateLabelButtonOptions, type CreateStandardBubbleOptions, type CreateThemeOptions, type CreateToggleGroupOptions, DEFAULT_COMPONENTS, DEFAULT_FLOATING_LAUNCHER_MAX_WIDTH, DEFAULT_FLOATING_LAUNCHER_WIDTH, DEFAULT_PALETTE, DEFAULT_SEMANTIC, DEFAULT_WIDGET_CONFIG, type DeepPartial, type DemoCarouselHandle, type DemoCarouselItem, type DemoCarouselOptions, type DomContextMode, type DomContextOptions, type DropdownMenuHandle, type DropdownMenuItem, type EnrichedPageElement, type EventStreamBadgeColor, type EventStreamConfig, type EventStreamPayloadRenderContext, type EventStreamRowRenderContext, type EventStreamToolbarRenderContext, type EventStreamViewRenderContext, type FallbackSpeechEngineOptions, type FormatEnrichedContextOptions, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type IconButtonTokens, type IconName, type IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectComponentDirectiveOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LabelButtonTokens, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, PRESETS, PRESET_FULLSCREEN, PRESET_MINIMAL, PRESET_SHOP, type ParseOptionsConfig, type ParseRule, type PcmStreamPlayer, type PendingAttachment, type PersonaArtifactKind, type PersonaArtifactManualUpsert, type PersonaArtifactRecord, type PersonaTheme, type PersonaThemePlugin, type RadiusScale, ReadAloudController, type ReadAloudListener, type ReadAloudState, type RuleScoringContext, type RuntypeClientChatRequest, type RuntypeClientChatStreamEvent, type RuntypeClientFeedbackRequest, type RuntypeClientFeedbackResponse, type RuntypeClientFeedbackType, type RuntypeClientInitRequest, type RuntypeClientInitResponse, type RuntypeClientResumeRequest, type RuntypeClientResumeStreamEvent, type RuntypeExecutionStreamEvent, type RuntypeFlowSSEEvent, type RuntypeStepCompleteEvent, type RuntypeStopReasonKind, type RuntypeStreamEventOf, type RuntypeTurnCompleteEvent, type SSEEventCallback, type SSEEventRecord, SUGGEST_REPLIES_CLIENT_TOOL, SUGGEST_REPLIES_PARAMETERS_SCHEMA, SUGGEST_REPLIES_TOOL_NAME, type SanitizeFunction, type SemanticColors, type SemanticSpacing, type SemanticTypography, type ShadowScale, type SlotRenderContext, type SlotRenderer, type SpacingScale, type SpeechCallbacks, type SpeechEngine, type SpeechRequest, type StreamAnimationContext, type StreamAnimationPlugin, THEME_ZONES, type TextContentPart, type ThemeValidationError, type ThemeValidationResult, type ThemeZone, type ToggleGroupHandle, type ToggleGroupItem, type ToggleGroupTokens, type TokenReference, type TypographyScale, VERSION, type VoiceConfig, type VoiceMetrics, type VoicePlaybackEngine, type VoiceProvider, type VoiceResult, type VoiceStatus, WEBMCP_TOOL_PREFIX, WebMcpBridge, type WebMcpConfirmHandler, type WebMcpConfirmInfo, type WebMcpToolResult, type WidgetHostLayout, type WidgetHostLayoutMode, type WidgetLayoutSlot, type WidgetPreset, accessibilityPlugin, animationsPlugin, applyThemeVariables, attachHeaderToContainer, brandPlugin, buildComposer, buildDefaultHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, builtInClientToolsForDispatch, collectEnrichedPageContext, componentRegistry, createActionManager, createAgentExperience, createAskUserQuestionBubble, createBestAvailableVoiceProvider, createBubbleWithLayout, createCSATFeedback, createComboButton, createComponentMiddleware, createComponentStreamParser, createDefaultSanitizer, createDemoCarousel, createDirectivePostprocessor, createDropdownMenu, createFlexibleJsonStreamParser, createIconButton, createImagePart, createJsonStreamParser, createLabelButton, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createPlugin, createRegexJsonParser, createStandardBubble, createTextPart, createTheme, createThemeObserver, createToggleGroup, createTypingIndicator, createVoiceProvider, createWidgetHostLayout, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, defaultParseRules, detectColorScheme, directivePostprocessor, ensureAskUserQuestionSheet, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, formatEnrichedContext, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateStableSelector, generateUserMessageId, getActiveTheme, getColorScheme, getDisplayText, getHeaderLayout, getImageParts, getPreset, hasComponentDirective, hasImages, headerLayouts, highContrastPlugin, initAgentWidget, isAskUserQuestionMessage, isComponentDirectiveType, isDockedMountMode, isSuggestRepliesMessage, isVoiceSupported, isWebMcpToolName, latestAgentSuggestions, listRegisteredStreamAnimations, markdownPostprocessor, mergeWithDefaults, normalizeContent, parseAskUserQuestionPayload, parseSuggestRepliesPayload, pickBestVoice, pluginRegistry, reducedMotionPlugin, registerStreamAnimationPlugin, removeAskUserQuestionSheet, renderComponentDirective, renderLoadingIndicatorWithFallback, renderLucideIcon, resolveDockConfig, resolveSanitizer, resolveTokens, stripWebMcpPrefix, themeToCssVariables, unregisterStreamAnimationPlugin, validateImageFile, validateTheme };