airbyte-agent-slack 0.1.30__py3-none-any.whl → 0.1.31__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.
@@ -17,9 +17,9 @@ from .models import (
17
17
  ChannelPurpose,
18
18
  ChannelsListResponse,
19
19
  ChannelResponse,
20
- File,
21
- Reaction,
22
20
  Attachment,
21
+ Reaction,
22
+ File,
23
23
  Message,
24
24
  Thread,
25
25
  EditedInfo,
@@ -95,9 +95,9 @@ __all__ = [
95
95
  "ChannelPurpose",
96
96
  "ChannelsListResponse",
97
97
  "ChannelResponse",
98
- "File",
99
- "Reaction",
100
98
  "Attachment",
99
+ "Reaction",
100
+ "File",
101
101
  "Message",
102
102
  "Thread",
103
103
  "EditedInfo",
@@ -380,7 +380,11 @@ def describe_entities(model: ConnectorModelProtocol) -> list[dict[str, Any]]:
380
380
  return entities
381
381
 
382
382
 
383
- def generate_tool_description(model: ConnectorModelProtocol) -> str:
383
+ def generate_tool_description(
384
+ model: ConnectorModelProtocol,
385
+ *,
386
+ enable_hosted_mode_features: bool = True,
387
+ ) -> str:
384
388
  """Generate AI tool description from connector metadata.
385
389
 
386
390
  Produces a detailed description that includes:
@@ -393,6 +397,7 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
393
397
 
394
398
  Args:
395
399
  model: Object conforming to ConnectorModelProtocol (e.g., ConnectorModel)
400
+ enable_hosted_mode_features: When False, omit hosted-mode search guidance from the docstring.
396
401
 
397
402
  Returns:
398
403
  Formatted description string suitable for AI tool documentation
@@ -402,8 +407,9 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
402
407
  # at the first empty line and only keeps the initial section.
403
408
 
404
409
  # Entity/action parameter details (including pagination params like limit, starting_after)
405
- search_field_paths = _collect_search_field_paths(model)
406
- lines.append("ENTITIES AND PARAMETERS:")
410
+ search_field_paths = _collect_search_field_paths(model) if enable_hosted_mode_features else {}
411
+ # Avoid a "PARAMETERS:" header because some docstring parsers treat it as a params section marker.
412
+ lines.append("ENTITIES (ACTIONS + PARAMS):")
407
413
  for entity in model.entities:
408
414
  lines.append(f" {entity.name}:")
409
415
  actions = getattr(entity, "actions", []) or []
@@ -427,8 +433,9 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
427
433
  lines.append(" To paginate: pass starting_after=<last_id> while has_more is true")
428
434
 
429
435
  lines.append("GUIDELINES:")
430
- lines.append(' - Prefer cached search over direct API calls when using execute(): action="search" whenever possible.')
431
- lines.append(" - Direct API actions (list/get/download) are slower and should be used only if search cannot answer the query.")
436
+ if enable_hosted_mode_features:
437
+ lines.append(' - Prefer cached search over direct API calls when using execute(): action="search" whenever possible.')
438
+ lines.append(" - Direct API actions (list/get/download) are slower and should be used only if search cannot answer the query.")
432
439
  lines.append(" - Keep results small: use params.fields, params.query.filter, small params.limit, and cursor pagination.")
433
440
  lines.append(" - If output is too large, refine the query with tighter filters/fields/limit.")
434
441
 
@@ -427,6 +427,7 @@ class SlackConnector:
427
427
  func: _F | None = None,
428
428
  *,
429
429
  update_docstring: bool = True,
430
+ enable_hosted_mode_features: bool = True,
430
431
  max_output_chars: int | None = DEFAULT_MAX_OUTPUT_CHARS,
431
432
  ) -> _F | Callable[[_F], _F]:
432
433
  """
@@ -445,12 +446,16 @@ class SlackConnector:
445
446
 
446
447
  Args:
447
448
  update_docstring: When True, append connector capabilities to __doc__.
449
+ enable_hosted_mode_features: When False, omit hosted-mode search sections from docstrings.
448
450
  max_output_chars: Max serialized output size before raising. Use None to disable.
449
451
  """
450
452
 
451
453
  def decorate(inner: _F) -> _F:
452
454
  if update_docstring:
453
- description = generate_tool_description(SlackConnectorModel)
455
+ description = generate_tool_description(
456
+ SlackConnectorModel,
457
+ enable_hosted_mode_features=enable_hosted_mode_features,
458
+ )
454
459
  original_doc = inner.__doc__ or ""
455
460
  if original_doc.strip():
456
461
  full_doc = f"{original_doc.strip()}\n{description}"
@@ -176,6 +176,35 @@ class ChannelResponse(BaseModel):
176
176
  ok: Union[bool, Any] = Field(default=None)
177
177
  channel: Union[Channel, Any] = Field(default=None)
178
178
 
179
+ class Attachment(BaseModel):
180
+ """Message attachment"""
181
+ model_config = ConfigDict(extra="allow", populate_by_name=True)
182
+
183
+ id: Union[int | None, Any] = Field(default=None)
184
+ fallback: Union[str | None, Any] = Field(default=None)
185
+ color: Union[str | None, Any] = Field(default=None)
186
+ pretext: Union[str | None, Any] = Field(default=None)
187
+ author_name: Union[str | None, Any] = Field(default=None)
188
+ author_link: Union[str | None, Any] = Field(default=None)
189
+ author_icon: Union[str | None, Any] = Field(default=None)
190
+ title: Union[str | None, Any] = Field(default=None)
191
+ title_link: Union[str | None, Any] = Field(default=None)
192
+ text: Union[str | None, Any] = Field(default=None)
193
+ fields: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
194
+ image_url: Union[str | None, Any] = Field(default=None)
195
+ thumb_url: Union[str | None, Any] = Field(default=None)
196
+ footer: Union[str | None, Any] = Field(default=None)
197
+ footer_icon: Union[str | None, Any] = Field(default=None)
198
+ ts: Union[Any, Any] = Field(default=None)
199
+
200
+ class Reaction(BaseModel):
201
+ """Message reaction"""
202
+ model_config = ConfigDict(extra="allow", populate_by_name=True)
203
+
204
+ name: Union[str | None, Any] = Field(default=None)
205
+ users: Union[list[str] | None, Any] = Field(default=None)
206
+ count: Union[int | None, Any] = Field(default=None)
207
+
179
208
  class File(BaseModel):
180
209
  """File object"""
181
210
  model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -200,35 +229,6 @@ class File(BaseModel):
200
229
  created: Union[int | None, Any] = Field(default=None)
201
230
  timestamp: Union[int | None, Any] = Field(default=None)
202
231
 
203
- class Reaction(BaseModel):
204
- """Message reaction"""
205
- model_config = ConfigDict(extra="allow", populate_by_name=True)
206
-
207
- name: Union[str | None, Any] = Field(default=None)
208
- users: Union[list[str] | None, Any] = Field(default=None)
209
- count: Union[int | None, Any] = Field(default=None)
210
-
211
- class Attachment(BaseModel):
212
- """Message attachment"""
213
- model_config = ConfigDict(extra="allow", populate_by_name=True)
214
-
215
- id: Union[int | None, Any] = Field(default=None)
216
- fallback: Union[str | None, Any] = Field(default=None)
217
- color: Union[str | None, Any] = Field(default=None)
218
- pretext: Union[str | None, Any] = Field(default=None)
219
- author_name: Union[str | None, Any] = Field(default=None)
220
- author_link: Union[str | None, Any] = Field(default=None)
221
- author_icon: Union[str | None, Any] = Field(default=None)
222
- title: Union[str | None, Any] = Field(default=None)
223
- title_link: Union[str | None, Any] = Field(default=None)
224
- text: Union[str | None, Any] = Field(default=None)
225
- fields: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
226
- image_url: Union[str | None, Any] = Field(default=None)
227
- thumb_url: Union[str | None, Any] = Field(default=None)
228
- footer: Union[str | None, Any] = Field(default=None)
229
- footer_icon: Union[str | None, Any] = Field(default=None)
230
- ts: Union[Any, Any] = Field(default=None)
231
-
232
232
  class Message(BaseModel):
233
233
  """Slack message object"""
234
234
  model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: airbyte-agent-slack
3
- Version: 0.1.30
3
+ Version: 0.1.31
4
4
  Summary: Airbyte Slack Connector for AI platforms
5
5
  Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
6
6
  Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
@@ -158,6 +158,6 @@ See the official [Slack API reference](https://api.slack.com/methods).
158
158
 
159
159
  ## Version information
160
160
 
161
- - **Package version:** 0.1.30
161
+ - **Package version:** 0.1.31
162
162
  - **Connector version:** 0.1.10
163
- - **Generated with Connector SDK commit SHA:** 9aef9bd212728c778fc1a8dbba36fe6d74ef1f8c
163
+ - **Generated with Connector SDK commit SHA:** f6c6fca292b291b200b31e4056856465129ae703
@@ -1,7 +1,7 @@
1
- airbyte_agent_slack/__init__.py,sha256=LI0Ft_RZcoyUgY6y00MYQDN9Cc93UeuqxtGwz0IIUV4,3703
2
- airbyte_agent_slack/connector.py,sha256=WEmUZx-1rzvpcVuqA4tJgu7ZKe8srDN0jpLQoPQh2o8,39589
1
+ airbyte_agent_slack/__init__.py,sha256=TDxULjzfyyXPzw-VQJjgA1WWc-qRMJ96vs5NHq_zupU,3703
2
+ airbyte_agent_slack/connector.py,sha256=qHDxLbxnn_NRG1wtTzbHC0R3zm8dJ2Rghhd6PeV3Zi0,39858
3
3
  airbyte_agent_slack/connector_model.py,sha256=ZZMvJ6z56KfY5Yo5XbHP2O3wl4X-RG3FrxBjiLMIZEo,194500
4
- airbyte_agent_slack/models.py,sha256=ovaECkXfG4iXG4uR9FZbsUJBcF_AJtPrGnldvuMjDYw,28916
4
+ airbyte_agent_slack/models.py,sha256=Vbnwtjz7om8TwxG2TQuKeGoZVroG8DZlNdZ9P6nlisI,28916
5
5
  airbyte_agent_slack/types.py,sha256=QDLOYuH23w4H_5fxVjTcBBz6BMYm2PWbuM1K_EOcD4o,32154
6
6
  airbyte_agent_slack/_vendored/__init__.py,sha256=ILl7AHXMui__swyrjxrh9yRa4dLiwBvV6axPWFWty80,38
7
7
  airbyte_agent_slack/_vendored/connector_sdk/__init__.py,sha256=T5o7roU6NSpH-lCAGZ338sE5dlh4ZU6i6IkeG1zpems,1949
@@ -12,7 +12,7 @@ airbyte_agent_slack/_vendored/connector_sdk/constants.py,sha256=AtzOvhDMWbRJgpsQ
12
12
  airbyte_agent_slack/_vendored/connector_sdk/exceptions.py,sha256=ss5MGv9eVPmsbLcLWetuu3sDmvturwfo6Pw3M37Oq5k,481
13
13
  airbyte_agent_slack/_vendored/connector_sdk/extensions.py,sha256=XWRRoJOOrwUHSKbuQt5DU7CCu8ePzhd_HuP7c_uD77w,21376
14
14
  airbyte_agent_slack/_vendored/connector_sdk/http_client.py,sha256=09Fclbq4wrg38EM2Yh2kHiykQVXqdAGby024elcEz8E,28027
15
- airbyte_agent_slack/_vendored/connector_sdk/introspection.py,sha256=kRVI4TDQDLdcCnTBUML8ycAtdqAQufVh-027sMkb4i8,19165
15
+ airbyte_agent_slack/_vendored/connector_sdk/introspection.py,sha256=e9uWn2ofpeehoBbzNgts_bjlKLn8ayA1Y3OpDC3b7ZA,19517
16
16
  airbyte_agent_slack/_vendored/connector_sdk/secrets.py,sha256=J9ezMu4xNnLW11xY5RCre6DHP7YMKZCqwGJfk7ufHAM,6855
17
17
  airbyte_agent_slack/_vendored/connector_sdk/types.py,sha256=in8gHsn5nsScujOfHZmkOgNmqmJKiPyNNjg59m5fGWc,8807
18
18
  airbyte_agent_slack/_vendored/connector_sdk/utils.py,sha256=G4LUXOC2HzPoND2v4tQW68R9uuPX9NQyCjaGxb7Kpl0,1958
@@ -52,6 +52,6 @@ airbyte_agent_slack/_vendored/connector_sdk/telemetry/__init__.py,sha256=RaLgkBU
52
52
  airbyte_agent_slack/_vendored/connector_sdk/telemetry/config.py,sha256=tLmQwAFD0kP1WyBGWBS3ysaudN9H3e-3EopKZi6cGKg,885
53
53
  airbyte_agent_slack/_vendored/connector_sdk/telemetry/events.py,sha256=8Y1NbXiwISX-V_wRofY7PqcwEXD0dLMnntKkY6XFU2s,1328
54
54
  airbyte_agent_slack/_vendored/connector_sdk/telemetry/tracker.py,sha256=Ftrk0_ddfM7dZG8hF9xBuPwhbc9D6JZ7Q9qs5o3LEyA,5579
55
- airbyte_agent_slack-0.1.30.dist-info/METADATA,sha256=yMpqo-Vjs2D-u9wXH3xjiau9SgQFjF4BmmWOeDaeF9k,6468
56
- airbyte_agent_slack-0.1.30.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
57
- airbyte_agent_slack-0.1.30.dist-info/RECORD,,
55
+ airbyte_agent_slack-0.1.31.dist-info/METADATA,sha256=Jxc1C_9vYWyH1bU4J135BVZZ6UO3n5z4Mmni8EZUmfI,6468
56
+ airbyte_agent_slack-0.1.31.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
57
+ airbyte_agent_slack-0.1.31.dist-info/RECORD,,