@runtypelabs/persona 3.37.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 (50) 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 +52 -52
  11. package/dist/index.cjs.map +1 -1
  12. package/dist/index.d.cts +327 -838
  13. package/dist/index.d.ts +327 -838
  14. package/dist/index.global.js +39 -39
  15. package/dist/index.global.js.map +1 -1
  16. package/dist/index.js +52 -52
  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 -191
  21. package/dist/smart-dom-reader.d.ts +268 -191
  22. package/dist/theme-editor-preview.cjs +53 -53
  23. package/dist/theme-editor-preview.d.cts +268 -191
  24. package/dist/theme-editor-preview.d.ts +268 -191
  25. package/dist/theme-editor-preview.js +55 -55
  26. package/dist/theme-editor.d.cts +268 -191
  27. package/dist/theme-editor.d.ts +268 -191
  28. package/package.json +1 -1
  29. package/src/client.test.ts +446 -1041
  30. package/src/client.ts +684 -967
  31. package/src/components/tool-bubble.ts +46 -33
  32. package/src/generated/runtype-openapi-contract.ts +210 -714
  33. package/src/index-core.ts +2 -3
  34. package/src/install.test.ts +1 -34
  35. package/src/install.ts +1 -26
  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 -12
  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 +62 -14
  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
  49. package/src/utils/unified-event-bridge.test.ts +0 -263
  50. package/src/utils/unified-event-bridge.ts +0 -431
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
- 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
1047
  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;
@@ -1976,7 +1473,7 @@ type RuntypeClientChatRequest = {
1976
1473
  submitMode?: "normal" | "interrupt";
1977
1474
  turnId?: string;
1978
1475
  };
1979
- type RuntypeClientChatStreamEvent = RuntypeFlowSSEEvent;
1476
+ type RuntypeClientChatStreamEvent = RuntypeExecutionStreamEvent;
1980
1477
  type RuntypeClientResumeRequest = {
1981
1478
  executionId: string;
1982
1479
  messages?: Array<{
@@ -2003,7 +1500,7 @@ type RuntypeClientResumeRequest = {
2003
1500
  streamResponse?: boolean;
2004
1501
  toolOutputs?: Record<string, unknown>;
2005
1502
  };
2006
- type RuntypeClientResumeStreamEvent = RuntypeDispatchSSEEvent;
1503
+ type RuntypeClientResumeStreamEvent = RuntypeExecutionStreamEvent;
2007
1504
  type RuntypeClientFeedbackRequest = {
2008
1505
  comment?: string;
2009
1506
  messageId?: string;
@@ -5364,6 +4861,11 @@ type AgentWidgetConfig = {
5364
4861
  * When provided, the widget uses agent loop execution instead of flow dispatch.
5365
4862
  * Mutually exclusive with `flowId`.
5366
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
+ *
5367
4869
  * @example
5368
4870
  * ```typescript
5369
4871
  * config: {
@@ -5834,16 +5336,6 @@ type AgentWidgetConfig = {
5834
5336
  * ```
5835
5337
  */
5836
5338
  parseSSEEvent?: AgentWidgetSSEEventParser;
5837
- /**
5838
- * Wire vocabulary requested from the dispatch endpoint.
5839
- * - `'legacy'` (default): the current `agent_*` / `flow_*` SSE events.
5840
- * - `'unified'`: opt into the API's neutral unified event vocabulary by sending
5841
- * `?events=unified`; incoming frames are transparently bridged back to the same
5842
- * handlers, so rendering is unchanged. Requires an upstream that honors the
5843
- * param — the widget detects the actual wire mode from the first stream frame
5844
- * and falls back to legacy automatically if the param was ignored.
5845
- */
5846
- events?: "legacy" | "unified";
5847
5339
  /**
5848
5340
  * Called for every parsed SSE frame (after JSON parse), before native handling.
5849
5341
  * Use for lightweight side effects (e.g. telemetry). Does not replace native
@@ -6023,6 +5515,12 @@ type AgentWidgetReasoning = {
6023
5515
  id: string;
6024
5516
  status: "pending" | "streaming" | "complete";
6025
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";
6026
5524
  startedAt?: number;
6027
5525
  completedAt?: number;
6028
5526
  durationMs?: number;
@@ -6381,8 +5879,6 @@ type AgentWidgetInitOptions = {
6381
5879
  useShadowDom?: boolean;
6382
5880
  /** Fired when the widget controller is mounted and its API is callable. */
6383
5881
  onChatReady?: () => void;
6384
- /** @deprecated Use `onChatReady`. Retained as an alias; removed in the next major. */
6385
- onReady?: () => void;
6386
5882
  windowKey?: string;
6387
5883
  debugTools?: boolean;
6388
5884
  };
@@ -6472,13 +5968,6 @@ declare class AgentWidgetClient {
6472
5968
  * Check if operating in agent execution mode
6473
5969
  */
6474
5970
  isAgentMode(): boolean;
6475
- /**
6476
- * Append `?events=unified` when the widget opted into the unified vocabulary,
6477
- * preserving any existing query string. No-op for the default legacy mode.
6478
- * The server only switches vocabularies when it sees the param; the widget
6479
- * still auto-detects the actual wire mode from the first stream frame.
6480
- */
6481
- private withEventsParam;
6482
5971
  /**
6483
5972
  * Get the appropriate API URL based on mode
6484
5973
  */
@@ -7214,6 +6703,83 @@ declare class AgentWidgetSession {
7214
6703
  private sortMessages;
7215
6704
  }
7216
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
+
7217
6783
  /**
7218
6784
  * Feedback UI components for CSAT and NPS collection
7219
6785
  */
@@ -7729,31 +7295,6 @@ declare const isWebMcpToolName: (name: string) => boolean;
7729
7295
 
7730
7296
  declare const createLocalStorageAdapter: (key?: string) => AgentWidgetStorageAdapter;
7731
7297
 
7732
- type ActionManagerProcessContext = {
7733
- text: string;
7734
- message: AgentWidgetMessage;
7735
- streaming: boolean;
7736
- raw?: string;
7737
- };
7738
- type ActionManagerOptions = {
7739
- parsers: AgentWidgetActionParser[];
7740
- handlers: AgentWidgetActionHandler[];
7741
- getSessionMetadata: () => Record<string, unknown>;
7742
- updateSessionMetadata: (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
7743
- emit: <K extends keyof AgentWidgetControllerEventMap>(event: K, payload: AgentWidgetControllerEventMap[K]) => void;
7744
- documentRef: Document | null;
7745
- };
7746
- declare const defaultJsonActionParser: AgentWidgetActionParser;
7747
- declare const defaultActionHandlers: Record<string, AgentWidgetActionHandler>;
7748
- declare const createActionManager: (options: ActionManagerOptions) => {
7749
- process: (context: ActionManagerProcessContext) => {
7750
- text: string;
7751
- persist: boolean;
7752
- resubmit?: boolean;
7753
- } | null;
7754
- syncFromMetadata: () => void;
7755
- };
7756
-
7757
7298
  /**
7758
7299
  * Options for creating a markdown processor
7759
7300
  */
@@ -8914,58 +8455,6 @@ declare function createComponentStreamParser(): {
8914
8455
  */
8915
8456
  declare function isComponentDirectiveType(obj: unknown): obj is ComponentDirective;
8916
8457
 
8917
- type LoadingIndicatorRenderer = (context: LoadingIndicatorRenderContext) => HTMLElement | null;
8918
- type MessageTransform = (context: {
8919
- text: string;
8920
- message: AgentWidgetMessage;
8921
- streaming: boolean;
8922
- raw?: string;
8923
- }) => string;
8924
- type MessageActionCallbacks = {
8925
- onCopy?: (message: AgentWidgetMessage) => void;
8926
- onFeedback?: (feedback: AgentWidgetMessageFeedback) => void;
8927
- };
8928
- declare const createTypingIndicator: () => HTMLElement;
8929
- /**
8930
- * Render loading indicator with fallback chain:
8931
- * 1. Custom renderer (if provided and returns non-null)
8932
- * 2. Default typing indicator
8933
- */
8934
- declare const renderLoadingIndicatorWithFallback: (location: "inline" | "standalone", customRenderer?: LoadingIndicatorRenderer, widgetConfig?: AgentWidgetConfig) => HTMLElement | null;
8935
- /**
8936
- * Create message action buttons (copy, upvote, downvote)
8937
- *
8938
- * This is a pure rendering function. It creates button elements with the
8939
- * correct `data-action` attributes, icons, and CSS classes. All click
8940
- * handling, vote state management, clipboard logic, and callback dispatch
8941
- * is handled via event delegation in `ui.ts` so that handlers survive
8942
- * idiomorph DOM morphing.
8943
- */
8944
- declare const createMessageActions: (message: AgentWidgetMessage, actionsConfig: AgentWidgetMessageActionsConfig, _callbacks?: MessageActionCallbacks) => HTMLElement;
8945
- /**
8946
- * Options for creating a standard message bubble
8947
- */
8948
- type CreateStandardBubbleOptions = {
8949
- /**
8950
- * Custom loading indicator renderer for inline location
8951
- */
8952
- loadingIndicatorRenderer?: LoadingIndicatorRenderer;
8953
- /**
8954
- * Full widget config (needed for loading indicator context)
8955
- */
8956
- widgetConfig?: AgentWidgetConfig;
8957
- };
8958
- /**
8959
- * Create standard message bubble
8960
- * Supports layout configuration for avatars, timestamps, and visual presets
8961
- */
8962
- declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
8963
- /**
8964
- * Create bubble with custom renderer support
8965
- * Uses custom renderer if provided in layout config, otherwise falls back to standard bubble
8966
- */
8967
- declare const createBubbleWithLayout: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
8968
-
8969
8458
  /**
8970
8459
  * Options for component middleware
8971
8460
  */
@@ -9357,4 +8846,4 @@ interface DemoCarouselHandle {
9357
8846
  }
9358
8847
  declare function createDemoCarousel(container: HTMLElement, options: DemoCarouselOptions): DemoCarouselHandle;
9359
8848
 
9360
- 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 };