takopi-slack-plugin 0.0.15__py3-none-any.whl

takopi_slack_plugin-0.0.15.dist-info/METADATA

@@ -0,0 +1,151 @@
+Metadata-Version: 2.3
+Name: takopi-slack-plugin
+Version: 0.0.15
+Summary: Slack transport plugin for Takopi.
+Keywords: takopi,slack,transport,plugin
+Author: takopi contributors
+License: MIT License
+         
+         Copyright (c) 2025 banteg
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Requires-Dist: anyio>=4.12.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: takopi>=0.20.0
+Requires-Dist: websockets>=12.0
+Requires-Python: >=3.14
+Project-URL: Homepage, https://zkp2p.xyz
+Description-Content-Type: text/markdown
+
+# takopi-slack-plugin
+
+slack transport plugin for takopi. socket mode only, replies in threads, and
+stores per-thread context + resume tokens.
+
+## features
+
+- socket mode only; listens in a single channel or dm
+- thread sessions (context + resume tokens) stored at
+  `~/.takopi/slack_thread_sessions_state.json`
+- slash commands + message shortcuts for overrides and plugin commands
+- cancel button on progress messages
+- message overflow: split or trim long responses
+
+## requirements
+
+- python 3.14+
+- takopi >=0.20.0
+- slack bot token with `chat:write`, `commands`, `app_mentions:read`, and
+  the matching history scopes for your channel type (`channels:history`,
+  `groups:history`, `im:history`, `mpim:history`)
+- slack app token (`xapp-`) with `connections:write`
+
+## install
+
+install into the same python environment as takopi.
+
+```sh
+uv tool install -U takopi --with takopi-slack-plugin
+```
+
+or, with a virtualenv:
+
+```sh
+pip install takopi-slack-plugin
+```
+
+## setup
+
+create a slack app and enable socket mode.
+
+1. create an app-level token with `connections:write`
+2. add the bot scopes listed above and install the app
+3. enable events for `app_mention` plus the right `message.*` event for your
+   channel type
+4. enable interactivity & shortcuts, create a slash command (for example
+   `/takopi`), and optionally add a message shortcut with callback id
+   `takopi:<plugin_id>`
+5. invite the bot to the target channel
+
+add to `~/.takopi/takopi.toml`:
+
+```toml
+transport = "slack"
+
+[transports.slack]
+bot_token = "xoxb-..."
+app_token = "xapp-..."
+channel_id = "C12345678"
+message_overflow = "split"
+```
+
+set `message_overflow = "trim"` if you prefer truncation instead of followups.
+
+if you use a plugin allowlist, enable this distribution:
+
+```toml
+[plugins]
+enabled = ["takopi-slack-plugin"]
+```
+
+## usage
+
+```sh
+takopi --transport slack
+```
+
+if you already set `transport = "slack"`, `takopi` is enough.
+
+root messages must include both a project and worktree directive in the first
+line. messages that do not match are ignored.
+
+example:
+
+```
+@takopi /zkp2p-clients @feat/web/monad-usdt0 add a retry to the api call
+```
+
+thread replies reuse stored context, so you can reply without repeating
+directives.
+
+slash command built-ins:
+
+```
+/takopi status
+/takopi engine <engine|clear>
+/takopi model <engine> <model|clear>
+/takopi reasoning <engine> <level|clear>
+/takopi session clear
+```
+
+message shortcuts pass the selected message text as arguments to the plugin
+command identified by `takopi:<plugin_id>`.
+
+progress messages include a cancel button; enable interactivity & shortcuts so
+clicks are delivered in socket mode.
+
+## license
+
+mit

takopi_slack_plugin-0.0.15.dist-info/RECORD

@@ -0,0 +1,17 @@
+takopi_slack_plugin/__init__.py,sha256=OrdTRcIxj3euY3X2MHgBWZxaxDkivQJkiLqLw8KsDf0,41
+takopi_slack_plugin/backend.py,sha256=Iq3NnwxP7YRcmEyJbBov4qCB3cw1AHkCFv-VJj0JGPs,6149
+takopi_slack_plugin/bridge.py,sha256=n_2a5N9iSs__nm6kUB0dmlNVhcQj6Z_Ahmcb9mpgVsQ,43599
+takopi_slack_plugin/client.py,sha256=n7uUzpwjbob4G5vbB5guylN357y5HaAulxtjq_8qcRc,7513
+takopi_slack_plugin/commands/__init__.py,sha256=u5H_TEDgTK0M_7VSXcKFFxg3K4Gk5siIbP638imscIE,113
+takopi_slack_plugin/commands/dispatch.py,sha256=Rf8YXEHELGPw55LiZNGubKMuCDUXQdHbOmTecGGWL9A,3292
+takopi_slack_plugin/commands/executor.py,sha256=eeTtpf-K0vCelcGcJdRYsdPDkW1O-K7IPCph9_Uy39I,6305
+takopi_slack_plugin/config.py,sha256=otTS7dLzil_du1UyDoLChLPVq5wDCTzJCGsYawHSbL8,2038
+takopi_slack_plugin/engine.py,sha256=msb7_3pT9_YtvNWne1Ou6ts-2XPcc3DP2EHsuVJ5pOE,4204
+takopi_slack_plugin/onboarding.py,sha256=7xgY3BDGkBWU9Mq0FqJs2Mt5sxGfhYAVwQodi03X_VU,1598
+takopi_slack_plugin/outbox.py,sha256=WyvFLGd9u0x2gDaE0SOSvqgnXxfFRwGwMWp33KpKeP4,5101
+takopi_slack_plugin/overrides.py,sha256=BrKSUZy72DK1VMqVzU2G_c3RM6hNQLl175FuT-IphOA,494
+takopi_slack_plugin/thread_sessions.py,sha256=RMfo1RvHeJKXYsgCtTw4H7P6GAp1eBwIBiqvx0K7Vm4,9412
+takopi_slack_plugin-0.0.15.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+takopi_slack_plugin-0.0.15.dist-info/entry_points.txt,sha256=jwKNzUWO-Vz1g0Gwlc6-LF5NsiDFt-WJeRbccHNbHgQ,73
+takopi_slack_plugin-0.0.15.dist-info/METADATA,sha256=-kWvR56DILbiHtuoKzpZh0M7l9MzdAe4F-Z3eW16LtA,4596
+takopi_slack_plugin-0.0.15.dist-info/RECORD,,

takopi_slack_plugin-0.0.15.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.26
+Root-Is-Purelib: true
+Tag: py3-none-any

takopi_slack_plugin-0.0.15.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[takopi.transport_backends]
+slack = takopi_slack_plugin.backend:BACKEND
+