Jeffrey Smith
fa2c4808d6
Some checks failed
CI/CD / detect-changes (pull_request) Successful in 21s
CI/CD / build-and-deploy (pull_request) Has been cancelled
CI/CD / test-frontend (pull_request) Has been cancelled
CI/CD / test-sqlite (pull_request) Has been cancelled
CI/CD / test-go-pg (pull_request) Has been cancelled
Conversation search (db.query search_like, chat-core /search endpoint, sidebar search UI), message pagination polish (scroll preservation, loading spinner), workflow-chat integration package, and multi-user E2E test infrastructure. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
42 lines
1.0 KiB
Markdown
42 lines
1.0 KiB
Markdown
# Workflow Chat Integration
|
|
|
|
Creates scoped chat conversations when workflow stages require team collaboration.
|
|
|
|
## Setup
|
|
|
|
1. Install the `workflow-chat` and `chat-core` packages.
|
|
2. In your workflow stage with `audience: team`, set `stage_config`:
|
|
|
|
```json
|
|
{
|
|
"on_advance": {
|
|
"package_id": "workflow-chat",
|
|
"entry_point": "on_advance"
|
|
}
|
|
}
|
|
```
|
|
|
|
3. When the workflow advances to that stage, ensure `stage_data` includes:
|
|
|
|
```json
|
|
{
|
|
"title": "Bug Triage Discussion",
|
|
"team_members": [
|
|
{"id": "user-1", "display_name": "Alice"},
|
|
{"id": "user-2", "display_name": "Bob"}
|
|
],
|
|
"creator_id": "user-1",
|
|
"creator_display_name": "Alice"
|
|
}
|
|
```
|
|
|
|
The hook will:
|
|
- Create a group conversation titled `"Bug Triage Discussion [abcd1234]"` (suffixed with instance ID)
|
|
- Add all team members as participants
|
|
- Send a system message linking to the workflow instance
|
|
- Enrich `stage_data` with the `conversation_id`
|
|
|
|
## Idempotency
|
|
|
|
If `stage_data` already contains a `conversation_id`, the hook returns `None` (no-op).
|