unique_toolkit 0.7.9__py3-none-any.whl → 0.7.11__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.
@@ -50,18 +50,18 @@ class ContentService:
50
50
  chat_id: str | None = None,
51
51
  ):
52
52
  self._event = event # Changed to protected attribute
53
- self.metadata_filter = None
53
+ self._metadata_filter = None
54
54
  if event:
55
- self.company_id = event.company_id
56
- self.user_id = event.user_id
55
+ self._company_id = event.company_id
56
+ self._user_id = event.user_id
57
57
  if isinstance(event, (ChatEvent, Event)):
58
- self.metadata_filter = event.payload.metadata_filter
59
- self.chat_id = event.payload.chat_id
58
+ self._metadata_filter = event.payload.metadata_filter
59
+ self._chat_id = event.payload.chat_id
60
60
  else:
61
61
  [company_id, user_id] = validate_required_values([company_id, user_id])
62
- self.company_id = company_id
63
- self.user_id = user_id
64
- self.chat_id = chat_id
62
+ self._company_id = company_id
63
+ self._user_id = user_id
64
+ self._chat_id = chat_id
65
65
 
66
66
  @property
67
67
  @deprecated(
@@ -76,6 +76,110 @@ class ContentService:
76
76
  """
77
77
  return self._event
78
78
 
79
+ @property
80
+ @deprecated(
81
+ "The company_id property is deprecated and will be removed in a future version."
82
+ )
83
+ def company_id(self) -> str | None:
84
+ """
85
+ Get the company identifier (deprecated).
86
+
87
+ Returns:
88
+ str | None: The company identifier.
89
+ """
90
+ return self._company_id
91
+
92
+ @company_id.setter
93
+ @deprecated(
94
+ "The company_id setter is deprecated and will be removed in a future version."
95
+ )
96
+ def company_id(self, value: str | None) -> None:
97
+ """
98
+ Set the company identifier (deprecated).
99
+
100
+ Args:
101
+ value (str | None): The company identifier.
102
+ """
103
+ self._company_id = value
104
+
105
+ @property
106
+ @deprecated(
107
+ "The user_id property is deprecated and will be removed in a future version."
108
+ )
109
+ def user_id(self) -> str | None:
110
+ """
111
+ Get the user identifier (deprecated).
112
+
113
+ Returns:
114
+ str | None: The user identifier.
115
+ """
116
+ return self._user_id
117
+
118
+ @user_id.setter
119
+ @deprecated(
120
+ "The user_id setter is deprecated and will be removed in a future version."
121
+ )
122
+ def user_id(self, value: str | None) -> None:
123
+ """
124
+ Set the user identifier (deprecated).
125
+
126
+ Args:
127
+ value (str | None): The user identifier.
128
+ """
129
+ self._user_id = value
130
+
131
+ @property
132
+ @deprecated(
133
+ "The chat_id property is deprecated and will be removed in a future version."
134
+ )
135
+ def chat_id(self) -> str | None:
136
+ """
137
+ Get the chat identifier (deprecated).
138
+
139
+ Returns:
140
+ str | None: The chat identifier.
141
+ """
142
+ return self._chat_id
143
+
144
+ @chat_id.setter
145
+ @deprecated(
146
+ "The chat_id setter is deprecated and will be removed in a future version."
147
+ )
148
+ def chat_id(self, value: str | None) -> None:
149
+ """
150
+ Set the chat identifier (deprecated).
151
+
152
+ Args:
153
+ value (str | None): The chat identifier.
154
+ """
155
+ self._chat_id = value
156
+
157
+ @property
158
+ @deprecated(
159
+ "The metadata_filter property is deprecated and will be removed in a future version."
160
+ )
161
+ def metadata_filter(self) -> dict | None:
162
+ """
163
+ Get the metadata filter (deprecated).
164
+
165
+ Returns:
166
+ dict | None: The metadata filter.
167
+ """
168
+ return self._metadata_filter
169
+
170
+ @metadata_filter.setter
171
+ @deprecated(
172
+ "The metadata_filter setter is deprecated and will be removed in a future version."
173
+ )
174
+ def metadata_filter(self, value: dict | None) -> None:
175
+ """
176
+ Set the metadata filter (deprecated).
177
+
178
+ Args:
179
+ value (dict | None): The metadata filter.
180
+ """
181
+ self._metadata_filter = value
182
+
79
183
  def search_content_chunks(
80
184
  self,
81
185
  search_string: str,
@@ -112,17 +216,17 @@ class ContentService:
112
216
  """
113
217
 
114
218
  if metadata_filter is None:
115
- metadata_filter = self.metadata_filter
219
+ metadata_filter = self._metadata_filter
116
220
 
117
- chat_id = chat_id or self.chat_id # type: ignore
221
+ chat_id = chat_id or self._chat_id # type: ignore
118
222
 
119
223
  if chat_only and not chat_id:
120
224
  raise ValueError("Please provide chat_id when limiting with chat_only")
121
225
 
122
226
  try:
123
227
  searches = search_content_chunks(
124
- user_id=self.user_id,
125
- company_id=self.company_id,
228
+ user_id=self._user_id,
229
+ company_id=self._company_id,
126
230
  chat_id=chat_id,
127
231
  search_string=search_string,
128
232
  search_type=search_type,
@@ -174,17 +278,17 @@ class ContentService:
174
278
  Exception: If there's an error during the search operation.
175
279
  """
176
280
  if metadata_filter is None:
177
- metadata_filter = self.metadata_filter
281
+ metadata_filter = self._metadata_filter
178
282
 
179
- chat_id = chat_id or self.chat_id # type: ignore
283
+ chat_id = chat_id or self._chat_id # type: ignore
180
284
 
181
285
  if chat_only and not chat_id:
182
286
  raise ValueError("Please provide chat_id when limiting with chat_only.")
183
287
 
184
288
  try:
185
289
  searches = await search_content_chunks_async(
186
- user_id=self.user_id,
187
- company_id=self.company_id,
290
+ user_id=self._user_id,
291
+ company_id=self._company_id,
188
292
  chat_id=chat_id,
189
293
  search_string=search_string,
190
294
  search_type=search_type,
@@ -216,11 +320,11 @@ class ContentService:
216
320
  Returns:
217
321
  list[Content]: The search results.
218
322
  """
219
- chat_id = chat_id or self.chat_id # type: ignore
323
+ chat_id = chat_id or self._chat_id # type: ignore
220
324
 
221
325
  return search_contents(
222
- user_id=self.user_id,
223
- company_id=self.company_id,
326
+ user_id=self._user_id,
327
+ company_id=self._company_id,
224
328
  chat_id=chat_id,
225
329
  where=where,
226
330
  )
@@ -239,11 +343,11 @@ class ContentService:
239
343
  Returns:
240
344
  list[Content]: The search results.
241
345
  """
242
- chat_id = chat_id or self.chat_id # type: ignore
346
+ chat_id = chat_id or self._chat_id # type: ignore
243
347
 
244
348
  return await search_contents_async(
245
- user_id=self.user_id,
246
- company_id=self.company_id,
349
+ user_id=self._user_id,
350
+ company_id=self._company_id,
247
351
  chat_id=chat_id,
248
352
  where=where,
249
353
  )
@@ -278,8 +382,8 @@ class ContentService:
278
382
  """
279
383
 
280
384
  return upload_content_from_bytes(
281
- user_id=self.user_id,
282
- company_id=self.company_id,
385
+ user_id=self._user_id,
386
+ company_id=self._company_id,
283
387
  content=content,
284
388
  content_name=content_name,
285
389
  mime_type=mime_type,
@@ -313,8 +417,8 @@ class ContentService:
313
417
  """
314
418
 
315
419
  return upload_content(
316
- user_id=self.user_id,
317
- company_id=self.company_id,
420
+ user_id=self._user_id,
421
+ company_id=self._company_id,
318
422
  path_to_content=path_to_content,
319
423
  content_name=content_name,
320
424
  mime_type=mime_type,
@@ -339,11 +443,11 @@ class ContentService:
339
443
  requests.Response: The response object containing the downloaded content.
340
444
 
341
445
  """
342
- chat_id = chat_id or self.chat_id # type: ignore
446
+ chat_id = chat_id or self._chat_id # type: ignore
343
447
 
344
448
  return request_content_by_id(
345
- user_id=self.user_id,
346
- company_id=self.company_id,
449
+ user_id=self._user_id,
450
+ company_id=self._company_id,
347
451
  content_id=content_id,
348
452
  chat_id=chat_id,
349
453
  )
@@ -371,11 +475,11 @@ class ContentService:
371
475
  Exception: If the download fails or the filename cannot be determined.
372
476
  """
373
477
 
374
- chat_id = chat_id or self.chat_id # type: ignore
478
+ chat_id = chat_id or self._chat_id # type: ignore
375
479
 
376
480
  return download_content_to_file_by_id(
377
- user_id=self.user_id,
378
- company_id=self.company_id,
481
+ user_id=self._user_id,
482
+ company_id=self._company_id,
379
483
  content_id=content_id,
380
484
  chat_id=chat_id,
381
485
  filename=filename,
@@ -406,11 +510,11 @@ class ContentService:
406
510
  Exception: If the download fails.
407
511
  """
408
512
 
409
- chat_id = chat_id or self.chat_id # type: ignore
513
+ chat_id = chat_id or self._chat_id # type: ignore
410
514
 
411
515
  return download_content(
412
- user_id=self.user_id,
413
- company_id=self.company_id,
516
+ user_id=self._user_id,
517
+ company_id=self._company_id,
414
518
  content_id=content_id,
415
519
  content_name=content_name,
416
520
  chat_id=chat_id,
@@ -435,10 +539,10 @@ class ContentService:
435
539
  Raises:
436
540
  Exception: If the download fails.
437
541
  """
438
- chat_id = chat_id or self.chat_id # type: ignore
542
+ chat_id = chat_id or self._chat_id # type: ignore
439
543
  return download_content_to_bytes(
440
- user_id=self.user_id,
441
- company_id=self.company_id,
544
+ user_id=self._user_id,
545
+ company_id=self._company_id,
442
546
  content_id=content_id,
443
547
  chat_id=chat_id,
444
548
  )
@@ -25,12 +25,12 @@ class EmbeddingService(BaseService):
25
25
  ):
26
26
  self._event = event
27
27
  if event:
28
- self.company_id = event.company_id
29
- self.user_id = event.user_id
28
+ self._company_id = event.company_id
29
+ self._user_id = event.user_id
30
30
  else:
31
31
  [company_id, user_id] = validate_required_values([company_id, user_id])
32
- self.company_id = company_id
33
- self.user_id = user_id
32
+ self._company_id = company_id
33
+ self._user_id = user_id
34
34
 
35
35
  @property
36
36
  @deprecated(
@@ -45,6 +45,58 @@ class EmbeddingService(BaseService):
45
45
  """
46
46
  return self._event
47
47
 
48
+ @property
49
+ @deprecated(
50
+ "The company_id property is deprecated and will be removed in a future version."
51
+ )
52
+ def company_id(self) -> str | None:
53
+ """
54
+ Get the company identifier (deprecated).
55
+
56
+ Returns:
57
+ str | None: The company identifier.
58
+ """
59
+ return self._company_id
60
+
61
+ @company_id.setter
62
+ @deprecated(
63
+ "The company_id setter is deprecated and will be removed in a future version."
64
+ )
65
+ def company_id(self, value: str | None) -> None:
66
+ """
67
+ Set the company identifier (deprecated).
68
+
69
+ Args:
70
+ value (str | None): The company identifier.
71
+ """
72
+ self._company_id = value
73
+
74
+ @property
75
+ @deprecated(
76
+ "The user_id property is deprecated and will be removed in a future version."
77
+ )
78
+ def user_id(self) -> str | None:
79
+ """
80
+ Get the user identifier (deprecated).
81
+
82
+ Returns:
83
+ str | None: The user identifier.
84
+ """
85
+ return self._user_id
86
+
87
+ @user_id.setter
88
+ @deprecated(
89
+ "The user_id setter is deprecated and will be removed in a future version."
90
+ )
91
+ def user_id(self, value: str | None) -> None:
92
+ """
93
+ Set the user identifier (deprecated).
94
+
95
+ Args:
96
+ value (str | None): The user identifier.
97
+ """
98
+ self._user_id = value
99
+
48
100
  def embed_texts(
49
101
  self,
50
102
  texts: list[str],
@@ -64,8 +116,8 @@ class EmbeddingService(BaseService):
64
116
  Exception: If an error occurs.
65
117
  """
66
118
  return embed_texts(
67
- user_id=self.user_id,
68
- company_id=self.company_id,
119
+ user_id=self._user_id,
120
+ company_id=self._company_id,
69
121
  texts=texts,
70
122
  timeout=timeout,
71
123
  )
@@ -89,8 +141,8 @@ class EmbeddingService(BaseService):
89
141
  Exception: If an error occurs.
90
142
  """
91
143
  return await embed_texts_async(
92
- user_id=self.user_id,
93
- company_id=self.company_id,
144
+ user_id=self._user_id,
145
+ company_id=self._company_id,
94
146
  texts=texts,
95
147
  timeout=timeout,
96
148
  )
@@ -97,7 +97,6 @@ class LanguageModelInfo(BaseModel):
97
97
  name=model_name,
98
98
  provider=LanguageModelProvider.AZURE,
99
99
  capabilities=[
100
- ModelCapabilities.STRUCTURED_OUTPUT,
101
100
  ModelCapabilities.FUNCTION_CALLING,
102
101
  ModelCapabilities.PARALLEL_FUNCTION_CALLING,
103
102
  ModelCapabilities.REPRODUCIBLE_OUTPUT,
@@ -150,7 +149,6 @@ class LanguageModelInfo(BaseModel):
150
149
  capabilities=[
151
150
  ModelCapabilities.FUNCTION_CALLING,
152
151
  ModelCapabilities.PARALLEL_FUNCTION_CALLING,
153
- ModelCapabilities.STRUCTURED_OUTPUT,
154
152
  ModelCapabilities.VISION,
155
153
  ModelCapabilities.STREAMING,
156
154
  ],
@@ -167,7 +165,6 @@ class LanguageModelInfo(BaseModel):
167
165
  name=model_name,
168
166
  encoder_name=EncoderName.O200K_BASE,
169
167
  capabilities=[
170
- ModelCapabilities.STRUCTURED_OUTPUT,
171
168
  ModelCapabilities.FUNCTION_CALLING,
172
169
  ModelCapabilities.PARALLEL_FUNCTION_CALLING,
173
170
  ModelCapabilities.STREAMING,
@@ -223,7 +220,6 @@ class LanguageModelInfo(BaseModel):
223
220
  return cls(
224
221
  name=model_name,
225
222
  capabilities=[
226
- ModelCapabilities.STRUCTURED_OUTPUT,
227
223
  ModelCapabilities.FUNCTION_CALLING,
228
224
  ModelCapabilities.PARALLEL_FUNCTION_CALLING,
229
225
  ModelCapabilities.STREAMING,
@@ -45,17 +45,17 @@ class LanguageModelService:
45
45
  assistant_id: str | None = None,
46
46
  ):
47
47
  self._event = event
48
- self.company_id = company_id
49
- self.user_id = user_id
50
- self.chat_id = chat_id
51
- self.assistant_id = assistant_id
48
+ self._company_id = company_id
49
+ self._user_id = user_id
50
+ self._chat_id = chat_id
51
+ self._assistant_id = assistant_id
52
52
 
53
53
  if event:
54
- self.company_id = event.company_id
55
- self.user_id = event.user_id
54
+ self._company_id = event.company_id
55
+ self._user_id = event.user_id
56
56
  if isinstance(event, (ChatEvent, Event)):
57
- self.chat_id = event.payload.chat_id
58
- self.assistant_id = event.payload.assistant_id
57
+ self._chat_id = event.payload.chat_id
58
+ self._assistant_id = event.payload.assistant_id
59
59
 
60
60
  @property
61
61
  @deprecated(
@@ -70,6 +70,110 @@ class LanguageModelService:
70
70
  """
71
71
  return self._event
72
72
 
73
+ @property
74
+ @deprecated(
75
+ "The company_id property is deprecated and will be removed in a future version."
76
+ )
77
+ def company_id(self) -> str | None:
78
+ """
79
+ Get the company identifier (deprecated).
80
+
81
+ Returns:
82
+ str | None: The company identifier.
83
+ """
84
+ return self._company_id
85
+
86
+ @company_id.setter
87
+ @deprecated(
88
+ "The company_id setter is deprecated and will be removed in a future version."
89
+ )
90
+ def company_id(self, value: str | None) -> None:
91
+ """
92
+ Set the company identifier (deprecated).
93
+
94
+ Args:
95
+ value (str | None): The company identifier.
96
+ """
97
+ self._company_id = value
98
+
99
+ @property
100
+ @deprecated(
101
+ "The user_id property is deprecated and will be removed in a future version."
102
+ )
103
+ def user_id(self) -> str | None:
104
+ """
105
+ Get the user identifier (deprecated).
106
+
107
+ Returns:
108
+ str | None: The user identifier.
109
+ """
110
+ return self._user_id
111
+
112
+ @user_id.setter
113
+ @deprecated(
114
+ "The user_id setter is deprecated and will be removed in a future version."
115
+ )
116
+ def user_id(self, value: str | None) -> None:
117
+ """
118
+ Set the user identifier (deprecated).
119
+
120
+ Args:
121
+ value (str | None): The user identifier.
122
+ """
123
+ self._user_id = value
124
+
125
+ @property
126
+ @deprecated(
127
+ "The chat_id property is deprecated and will be removed in a future version."
128
+ )
129
+ def chat_id(self) -> str | None:
130
+ """
131
+ Get the chat identifier (deprecated).
132
+
133
+ Returns:
134
+ str | None: The chat identifier.
135
+ """
136
+ return self._chat_id
137
+
138
+ @chat_id.setter
139
+ @deprecated(
140
+ "The chat_id setter is deprecated and will be removed in a future version."
141
+ )
142
+ def chat_id(self, value: str | None) -> None:
143
+ """
144
+ Set the chat identifier (deprecated).
145
+
146
+ Args:
147
+ value (str | None): The chat identifier.
148
+ """
149
+ self._chat_id = value
150
+
151
+ @property
152
+ @deprecated(
153
+ "The assistant_id property is deprecated and will be removed in a future version."
154
+ )
155
+ def assistant_id(self) -> str | None:
156
+ """
157
+ Get the assistant identifier (deprecated).
158
+
159
+ Returns:
160
+ str | None: The assistant identifier.
161
+ """
162
+ return self._assistant_id
163
+
164
+ @assistant_id.setter
165
+ @deprecated(
166
+ "The assistant_id setter is deprecated and will be removed in a future version."
167
+ )
168
+ def assistant_id(self, value: str | None) -> None:
169
+ """
170
+ Set the assistant identifier (deprecated).
171
+
172
+ Args:
173
+ value (str | None): The assistant identifier.
174
+ """
175
+ self._assistant_id = value
176
+
73
177
  def complete(
74
178
  self,
75
179
  messages: LanguageModelMessages,
@@ -84,7 +188,7 @@ class LanguageModelService:
84
188
  """
85
189
  Calls the completion endpoint synchronously without streaming the response.
86
190
  """
87
- [company_id] = validate_required_values([self.company_id])
191
+ [company_id] = validate_required_values([self._company_id])
88
192
 
89
193
  return complete(
90
194
  company_id=company_id,
@@ -112,7 +216,7 @@ class LanguageModelService:
112
216
  """
113
217
  Calls the completion endpoint asynchronously without streaming the response.
114
218
  """
115
- [company_id] = validate_required_values([self.company_id])
219
+ [company_id] = validate_required_values([self._company_id])
116
220
 
117
221
  return await complete_async(
118
222
  company_id=company_id,