letta-client 1.0.0a3__py3-none-any.whl → 1.0.0a5__py3-none-any.whl

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.

Potentially problematic release.

This version of letta-client might be problematic. Click here for more details.

Files changed (85) hide show
  1. letta_client/__init__.py +10 -0
  2. letta_client/agents/blocks/client.py +28 -14
  3. letta_client/agents/blocks/raw_client.py +14 -0
  4. letta_client/agents/client.py +36 -8
  5. letta_client/agents/context/client.py +4 -2
  6. letta_client/agents/context/raw_client.py +2 -0
  7. letta_client/agents/core_memory/client.py +4 -2
  8. letta_client/agents/core_memory/raw_client.py +2 -0
  9. letta_client/agents/files/client.py +24 -12
  10. letta_client/agents/files/raw_client.py +12 -0
  11. letta_client/agents/folders/client.py +20 -10
  12. letta_client/agents/folders/raw_client.py +10 -0
  13. letta_client/agents/groups/client.py +4 -2
  14. letta_client/agents/groups/raw_client.py +2 -0
  15. letta_client/agents/messages/client.py +40 -20
  16. letta_client/agents/messages/raw_client.py +20 -0
  17. letta_client/agents/passages/client.py +16 -8
  18. letta_client/agents/passages/raw_client.py +8 -0
  19. letta_client/agents/raw_client.py +28 -0
  20. letta_client/agents/sources/client.py +20 -10
  21. letta_client/agents/sources/raw_client.py +10 -0
  22. letta_client/agents/tools/client.py +24 -12
  23. letta_client/agents/tools/raw_client.py +12 -0
  24. letta_client/archives/client.py +4 -2
  25. letta_client/archives/raw_client.py +2 -0
  26. letta_client/blocks/agents/client.py +4 -2
  27. letta_client/blocks/agents/raw_client.py +2 -0
  28. letta_client/blocks/client.py +12 -6
  29. letta_client/blocks/raw_client.py +6 -0
  30. letta_client/core/client_wrapper.py +2 -2
  31. letta_client/groups/client.py +12 -6
  32. letta_client/groups/messages/client.py +24 -12
  33. letta_client/groups/messages/raw_client.py +12 -0
  34. letta_client/groups/raw_client.py +6 -0
  35. letta_client/identities/agents/client.py +4 -2
  36. letta_client/identities/agents/raw_client.py +2 -0
  37. letta_client/identities/blocks/client.py +4 -2
  38. letta_client/identities/blocks/raw_client.py +2 -0
  39. letta_client/identities/client.py +12 -6
  40. letta_client/identities/properties/client.py +4 -2
  41. letta_client/identities/properties/raw_client.py +2 -0
  42. letta_client/identities/raw_client.py +6 -0
  43. letta_client/jobs/client.py +12 -6
  44. letta_client/jobs/raw_client.py +6 -0
  45. letta_client/providers/client.py +16 -8
  46. letta_client/providers/raw_client.py +8 -0
  47. letta_client/sources/client.py +24 -12
  48. letta_client/sources/files/client.py +16 -8
  49. letta_client/sources/files/raw_client.py +8 -0
  50. letta_client/sources/passages/client.py +4 -2
  51. letta_client/sources/passages/raw_client.py +2 -0
  52. letta_client/sources/raw_client.py +12 -0
  53. letta_client/steps/client.py +4 -2
  54. letta_client/steps/feedback/client.py +4 -2
  55. letta_client/steps/feedback/raw_client.py +2 -0
  56. letta_client/steps/messages/client.py +4 -2
  57. letta_client/steps/messages/raw_client.py +2 -0
  58. letta_client/steps/metrics/client.py +4 -2
  59. letta_client/steps/metrics/raw_client.py +2 -0
  60. letta_client/steps/raw_client.py +2 -0
  61. letta_client/steps/trace/client.py +4 -2
  62. letta_client/steps/trace/raw_client.py +2 -0
  63. letta_client/templates/__init__.py +8 -0
  64. letta_client/templates/types/__init__.py +16 -0
  65. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_llm_config.py +6 -0
  66. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_llm_config_parallel_tool_calls.py +14 -0
  67. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_llm_config_parallel_tool_calls_item.py +7 -0
  68. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tools_item.py +6 -0
  69. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tools_item_enable_parallel_execution.py +15 -0
  70. letta_client/templates/types/templates_create_agents_from_template_response_agents_item_tools_item_enable_parallel_execution_item.py +7 -0
  71. letta_client/tools/client.py +42 -6
  72. letta_client/tools/raw_client.py +36 -0
  73. letta_client/types/__init__.py +2 -0
  74. letta_client/types/approval_request_message.py +6 -0
  75. letta_client/types/approval_request_message_tool_calls.py +8 -0
  76. letta_client/types/internal_template_agent_create.py +5 -0
  77. letta_client/types/letta_schemas_agent_file_agent_schema.py +5 -0
  78. letta_client/types/letta_schemas_agent_file_tool_schema.py +5 -0
  79. letta_client/types/llm_config.py +5 -0
  80. letta_client/types/run_metrics.py +5 -0
  81. letta_client/types/tool.py +5 -0
  82. letta_client/types/tool_create.py +5 -0
  83. {letta_client-1.0.0a3.dist-info → letta_client-1.0.0a5.dist-info}/METADATA +1 -1
  84. {letta_client-1.0.0a3.dist-info → letta_client-1.0.0a5.dist-info}/RECORD +85 -80
  85. {letta_client-1.0.0a3.dist-info → letta_client-1.0.0a5.dist-info}/WHEEL +0 -0
letta_client/agents/files/client.py CHANGED
@@ -34,6 +34,7 @@ class FilesClient:
34
34
  Parameters
35
35
  ----------
36
36
  agent_id : str
37
+ The ID of the agent in the format 'agent-<uuid4>'
37
38
 
38
39
  request_options : typing.Optional[RequestOptions]
39
40
  Request-specific configuration.
@@ -52,7 +53,7 @@ class FilesClient:
52
53
  token="YOUR_TOKEN",
53
54
  )
54
55
  client.agents.files.close_all(
55
- agent_id="agent_id",
56
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
56
57
  )
57
58
  """
58
59
  _response = self._raw_client.close_all(agent_id, request_options=request_options)
@@ -71,8 +72,10 @@ class FilesClient:
71
72
  Parameters
72
73
  ----------
73
74
  agent_id : str
75
+ The ID of the agent in the format 'agent-<uuid4>'
74
76
 
75
77
  file_id : str
78
+ The ID of the file in the format 'file-<uuid4>'
76
79
 
77
80
  request_options : typing.Optional[RequestOptions]
78
81
  Request-specific configuration.
@@ -91,8 +94,8 @@ class FilesClient:
91
94
  token="YOUR_TOKEN",
92
95
  )
93
96
  client.agents.files.open(
94
- agent_id="agent_id",
95
- file_id="file_id",
97
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
98
+ file_id="file-123e4567-e89b-42d3-8456-426614174000",
96
99
  )
97
100
  """
98
101
  _response = self._raw_client.open(agent_id, file_id, request_options=request_options)
@@ -110,8 +113,10 @@ class FilesClient:
110
113
  Parameters
111
114
  ----------
112
115
  agent_id : str
116
+ The ID of the agent in the format 'agent-<uuid4>'
113
117
 
114
118
  file_id : str
119
+ The ID of the file in the format 'file-<uuid4>'
115
120
 
116
121
  request_options : typing.Optional[RequestOptions]
117
122
  Request-specific configuration.
@@ -130,8 +135,8 @@ class FilesClient:
130
135
  token="YOUR_TOKEN",
131
136
  )
132
137
  client.agents.files.close(
133
- agent_id="agent_id",
134
- file_id="file_id",
138
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
139
+ file_id="file-123e4567-e89b-42d3-8456-426614174000",
135
140
  )
136
141
  """
137
142
  _response = self._raw_client.close(agent_id, file_id, request_options=request_options)
@@ -156,6 +161,7 @@ class FilesClient:
156
161
  Parameters
157
162
  ----------
158
163
  agent_id : str
164
+ The ID of the agent in the format 'agent-<uuid4>'
159
165
 
160
166
  before : typing.Optional[str]
161
167
  File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
@@ -195,7 +201,7 @@ class FilesClient:
195
201
  token="YOUR_TOKEN",
196
202
  )
197
203
  client.agents.files.list(
198
- agent_id="agent_id",
204
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
199
205
  before="before",
200
206
  after="after",
201
207
  limit=1,
@@ -245,6 +251,7 @@ class AsyncFilesClient:
245
251
  Parameters
246
252
  ----------
247
253
  agent_id : str
254
+ The ID of the agent in the format 'agent-<uuid4>'
248
255
 
249
256
  request_options : typing.Optional[RequestOptions]
250
257
  Request-specific configuration.
@@ -268,7 +275,7 @@ class AsyncFilesClient:
268
275
 
269
276
  async def main() -> None:
270
277
  await client.agents.files.close_all(
271
- agent_id="agent_id",
278
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
272
279
  )
273
280
 
274
281
 
@@ -290,8 +297,10 @@ class AsyncFilesClient:
290
297
  Parameters
291
298
  ----------
292
299
  agent_id : str
300
+ The ID of the agent in the format 'agent-<uuid4>'
293
301
 
294
302
  file_id : str
303
+ The ID of the file in the format 'file-<uuid4>'
295
304
 
296
305
  request_options : typing.Optional[RequestOptions]
297
306
  Request-specific configuration.
@@ -315,8 +324,8 @@ class AsyncFilesClient:
315
324
 
316
325
  async def main() -> None:
317
326
  await client.agents.files.open(
318
- agent_id="agent_id",
319
- file_id="file_id",
327
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
328
+ file_id="file-123e4567-e89b-42d3-8456-426614174000",
320
329
  )
321
330
 
322
331
 
@@ -337,8 +346,10 @@ class AsyncFilesClient:
337
346
  Parameters
338
347
  ----------
339
348
  agent_id : str
349
+ The ID of the agent in the format 'agent-<uuid4>'
340
350
 
341
351
  file_id : str
352
+ The ID of the file in the format 'file-<uuid4>'
342
353
 
343
354
  request_options : typing.Optional[RequestOptions]
344
355
  Request-specific configuration.
@@ -362,8 +373,8 @@ class AsyncFilesClient:
362
373
 
363
374
  async def main() -> None:
364
375
  await client.agents.files.close(
365
- agent_id="agent_id",
366
- file_id="file_id",
376
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
377
+ file_id="file-123e4567-e89b-42d3-8456-426614174000",
367
378
  )
368
379
 
369
380
 
@@ -391,6 +402,7 @@ class AsyncFilesClient:
391
402
  Parameters
392
403
  ----------
393
404
  agent_id : str
405
+ The ID of the agent in the format 'agent-<uuid4>'
394
406
 
395
407
  before : typing.Optional[str]
396
408
  File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
@@ -435,7 +447,7 @@ class AsyncFilesClient:
435
447
 
436
448
  async def main() -> None:
437
449
  await client.agents.files.list(
438
- agent_id="agent_id",
450
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
439
451
  before="before",
440
452
  after="after",
441
453
  limit=1,
letta_client/agents/files/raw_client.py CHANGED
@@ -31,6 +31,7 @@ class RawFilesClient:
31
31
  Parameters
32
32
  ----------
33
33
  agent_id : str
34
+ The ID of the agent in the format 'agent-<uuid4>'
34
35
 
35
36
  request_options : typing.Optional[RequestOptions]
36
37
  Request-specific configuration.
@@ -84,8 +85,10 @@ class RawFilesClient:
84
85
  Parameters
85
86
  ----------
86
87
  agent_id : str
88
+ The ID of the agent in the format 'agent-<uuid4>'
87
89
 
88
90
  file_id : str
91
+ The ID of the file in the format 'file-<uuid4>'
89
92
 
90
93
  request_options : typing.Optional[RequestOptions]
91
94
  Request-specific configuration.
@@ -138,8 +141,10 @@ class RawFilesClient:
138
141
  Parameters
139
142
  ----------
140
143
  agent_id : str
144
+ The ID of the agent in the format 'agent-<uuid4>'
141
145
 
142
146
  file_id : str
147
+ The ID of the file in the format 'file-<uuid4>'
143
148
 
144
149
  request_options : typing.Optional[RequestOptions]
145
150
  Request-specific configuration.
@@ -201,6 +206,7 @@ class RawFilesClient:
201
206
  Parameters
202
207
  ----------
203
208
  agent_id : str
209
+ The ID of the agent in the format 'agent-<uuid4>'
204
210
 
205
211
  before : typing.Optional[str]
206
212
  File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
@@ -288,6 +294,7 @@ class AsyncRawFilesClient:
288
294
  Parameters
289
295
  ----------
290
296
  agent_id : str
297
+ The ID of the agent in the format 'agent-<uuid4>'
291
298
 
292
299
  request_options : typing.Optional[RequestOptions]
293
300
  Request-specific configuration.
@@ -341,8 +348,10 @@ class AsyncRawFilesClient:
341
348
  Parameters
342
349
  ----------
343
350
  agent_id : str
351
+ The ID of the agent in the format 'agent-<uuid4>'
344
352
 
345
353
  file_id : str
354
+ The ID of the file in the format 'file-<uuid4>'
346
355
 
347
356
  request_options : typing.Optional[RequestOptions]
348
357
  Request-specific configuration.
@@ -395,8 +404,10 @@ class AsyncRawFilesClient:
395
404
  Parameters
396
405
  ----------
397
406
  agent_id : str
407
+ The ID of the agent in the format 'agent-<uuid4>'
398
408
 
399
409
  file_id : str
410
+ The ID of the file in the format 'file-<uuid4>'
400
411
 
401
412
  request_options : typing.Optional[RequestOptions]
402
413
  Request-specific configuration.
@@ -458,6 +469,7 @@ class AsyncRawFilesClient:
458
469
  Parameters
459
470
  ----------
460
471
  agent_id : str
472
+ The ID of the agent in the format 'agent-<uuid4>'
461
473
 
462
474
  before : typing.Optional[str]
463
475
  File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
letta_client/agents/folders/client.py CHANGED
@@ -34,8 +34,10 @@ class FoldersClient:
34
34
  Parameters
35
35
  ----------
36
36
  agent_id : str
37
+ The ID of the source in the format 'source-<uuid4>'
37
38
 
38
39
  folder_id : str
40
+ The ID of the agent in the format 'agent-<uuid4>'
39
41
 
40
42
  request_options : typing.Optional[RequestOptions]
41
43
  Request-specific configuration.
@@ -54,8 +56,8 @@ class FoldersClient:
54
56
  token="YOUR_TOKEN",
55
57
  )
56
58
  client.agents.folders.attach(
57
- agent_id="agent_id",
58
- folder_id="folder_id",
59
+ agent_id="source-123e4567-e89b-42d3-8456-426614174000",
60
+ folder_id="agent-123e4567-e89b-42d3-8456-426614174000",
59
61
  )
60
62
  """
61
63
  _response = self._raw_client.attach(agent_id, folder_id, request_options=request_options)
@@ -70,8 +72,10 @@ class FoldersClient:
70
72
  Parameters
71
73
  ----------
72
74
  agent_id : str
75
+ The ID of the source in the format 'source-<uuid4>'
73
76
 
74
77
  folder_id : str
78
+ The ID of the agent in the format 'agent-<uuid4>'
75
79
 
76
80
  request_options : typing.Optional[RequestOptions]
77
81
  Request-specific configuration.
@@ -90,8 +94,8 @@ class FoldersClient:
90
94
  token="YOUR_TOKEN",
91
95
  )
92
96
  client.agents.folders.detach(
93
- agent_id="agent_id",
94
- folder_id="folder_id",
97
+ agent_id="source-123e4567-e89b-42d3-8456-426614174000",
98
+ folder_id="agent-123e4567-e89b-42d3-8456-426614174000",
95
99
  )
96
100
  """
97
101
  _response = self._raw_client.detach(agent_id, folder_id, request_options=request_options)
@@ -114,6 +118,7 @@ class FoldersClient:
114
118
  Parameters
115
119
  ----------
116
120
  agent_id : str
121
+ The ID of the agent in the format 'agent-<uuid4>'
117
122
 
118
123
  before : typing.Optional[str]
119
124
  Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order
@@ -147,7 +152,7 @@ class FoldersClient:
147
152
  token="YOUR_TOKEN",
148
153
  )
149
154
  client.agents.folders.list(
150
- agent_id="agent_id",
155
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
151
156
  before="before",
152
157
  after="after",
153
158
  limit=1,
@@ -190,8 +195,10 @@ class AsyncFoldersClient:
190
195
  Parameters
191
196
  ----------
192
197
  agent_id : str
198
+ The ID of the source in the format 'source-<uuid4>'
193
199
 
194
200
  folder_id : str
201
+ The ID of the agent in the format 'agent-<uuid4>'
195
202
 
196
203
  request_options : typing.Optional[RequestOptions]
197
204
  Request-specific configuration.
@@ -215,8 +222,8 @@ class AsyncFoldersClient:
215
222
 
216
223
  async def main() -> None:
217
224
  await client.agents.folders.attach(
218
- agent_id="agent_id",
219
- folder_id="folder_id",
225
+ agent_id="source-123e4567-e89b-42d3-8456-426614174000",
226
+ folder_id="agent-123e4567-e89b-42d3-8456-426614174000",
220
227
  )
221
228
 
222
229
 
@@ -234,8 +241,10 @@ class AsyncFoldersClient:
234
241
  Parameters
235
242
  ----------
236
243
  agent_id : str
244
+ The ID of the source in the format 'source-<uuid4>'
237
245
 
238
246
  folder_id : str
247
+ The ID of the agent in the format 'agent-<uuid4>'
239
248
 
240
249
  request_options : typing.Optional[RequestOptions]
241
250
  Request-specific configuration.
@@ -259,8 +268,8 @@ class AsyncFoldersClient:
259
268
 
260
269
  async def main() -> None:
261
270
  await client.agents.folders.detach(
262
- agent_id="agent_id",
263
- folder_id="folder_id",
271
+ agent_id="source-123e4567-e89b-42d3-8456-426614174000",
272
+ folder_id="agent-123e4567-e89b-42d3-8456-426614174000",
264
273
  )
265
274
 
266
275
 
@@ -286,6 +295,7 @@ class AsyncFoldersClient:
286
295
  Parameters
287
296
  ----------
288
297
  agent_id : str
298
+ The ID of the agent in the format 'agent-<uuid4>'
289
299
 
290
300
  before : typing.Optional[str]
291
301
  Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order
@@ -324,7 +334,7 @@ class AsyncFoldersClient:
324
334
 
325
335
  async def main() -> None:
326
336
  await client.agents.folders.list(
327
- agent_id="agent_id",
337
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
328
338
  before="before",
329
339
  after="after",
330
340
  limit=1,
letta_client/agents/folders/raw_client.py CHANGED
@@ -29,8 +29,10 @@ class RawFoldersClient:
29
29
  Parameters
30
30
  ----------
31
31
  agent_id : str
32
+ The ID of the source in the format 'source-<uuid4>'
32
33
 
33
34
  folder_id : str
35
+ The ID of the agent in the format 'agent-<uuid4>'
34
36
 
35
37
  request_options : typing.Optional[RequestOptions]
36
38
  Request-specific configuration.
@@ -80,8 +82,10 @@ class RawFoldersClient:
80
82
  Parameters
81
83
  ----------
82
84
  agent_id : str
85
+ The ID of the source in the format 'source-<uuid4>'
83
86
 
84
87
  folder_id : str
88
+ The ID of the agent in the format 'agent-<uuid4>'
85
89
 
86
90
  request_options : typing.Optional[RequestOptions]
87
91
  Request-specific configuration.
@@ -139,6 +143,7 @@ class RawFoldersClient:
139
143
  Parameters
140
144
  ----------
141
145
  agent_id : str
146
+ The ID of the agent in the format 'agent-<uuid4>'
142
147
 
143
148
  before : typing.Optional[str]
144
149
  Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order
@@ -215,8 +220,10 @@ class AsyncRawFoldersClient:
215
220
  Parameters
216
221
  ----------
217
222
  agent_id : str
223
+ The ID of the source in the format 'source-<uuid4>'
218
224
 
219
225
  folder_id : str
226
+ The ID of the agent in the format 'agent-<uuid4>'
220
227
 
221
228
  request_options : typing.Optional[RequestOptions]
222
229
  Request-specific configuration.
@@ -266,8 +273,10 @@ class AsyncRawFoldersClient:
266
273
  Parameters
267
274
  ----------
268
275
  agent_id : str
276
+ The ID of the source in the format 'source-<uuid4>'
269
277
 
270
278
  folder_id : str
279
+ The ID of the agent in the format 'agent-<uuid4>'
271
280
 
272
281
  request_options : typing.Optional[RequestOptions]
273
282
  Request-specific configuration.
@@ -325,6 +334,7 @@ class AsyncRawFoldersClient:
325
334
  Parameters
326
335
  ----------
327
336
  agent_id : str
337
+ The ID of the agent in the format 'agent-<uuid4>'
328
338
 
329
339
  before : typing.Optional[str]
330
340
  Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order
letta_client/agents/groups/client.py CHANGED
@@ -42,6 +42,7 @@ class GroupsClient:
42
42
  Parameters
43
43
  ----------
44
44
  agent_id : str
45
+ The ID of the agent in the format 'agent-<uuid4>'
45
46
 
46
47
  manager_type : typing.Optional[str]
47
48
  Manager type to filter groups by
@@ -78,7 +79,7 @@ class GroupsClient:
78
79
  token="YOUR_TOKEN",
79
80
  )
80
81
  client.agents.groups.list(
81
- agent_id="agent_id",
82
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
82
83
  manager_type="manager_type",
83
84
  before="before",
84
85
  after="after",
@@ -132,6 +133,7 @@ class AsyncGroupsClient:
132
133
  Parameters
133
134
  ----------
134
135
  agent_id : str
136
+ The ID of the agent in the format 'agent-<uuid4>'
135
137
 
136
138
  manager_type : typing.Optional[str]
137
139
  Manager type to filter groups by
@@ -173,7 +175,7 @@ class AsyncGroupsClient:
173
175
 
174
176
  async def main() -> None:
175
177
  await client.agents.groups.list(
176
- agent_id="agent_id",
178
+ agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
177
179
  manager_type="manager_type",
178
180
  before="before",
179
181
  after="after",
letta_client/agents/groups/raw_client.py CHANGED
@@ -37,6 +37,7 @@ class RawGroupsClient:
37
37
  Parameters
38
38
  ----------
39
39
  agent_id : str
40
+ The ID of the agent in the format 'agent-<uuid4>'
40
41
 
41
42
  manager_type : typing.Optional[str]
42
43
  Manager type to filter groups by
@@ -126,6 +127,7 @@ class AsyncRawGroupsClient:
126
127
  Parameters
127
128
  ----------
128
129
  agent_id : str
130
+ The ID of the agent in the format 'agent-<uuid4>'
129
131
 
130
132
  manager_type : typing.Optional[str]
131
133
  Manager type to filter groups by