@cuylabs/channel-slack-agent-core 0.8.0 → 0.9.0

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.
Files changed (43) hide show
  1. package/README.md +4 -2
  2. package/dist/adapter/index.d.ts +6 -5
  3. package/dist/adapter/index.js +2 -2
  4. package/dist/{adapter-B3CI611y.d.ts → adapter-vbqtraAr.d.ts} +1 -1
  5. package/dist/app-surface.d.ts +6 -5
  6. package/dist/app-surface.js +4 -4
  7. package/dist/app.d.ts +6 -5
  8. package/dist/app.js +5 -5
  9. package/dist/assistant/index.d.ts +5 -4
  10. package/dist/assistant/index.js +2 -2
  11. package/dist/{chunk-TCNJY7QA.js → chunk-D4CSEAIF.js} +1 -1
  12. package/dist/{chunk-7YZWCSML.js → chunk-FJP6ZFUB.js} +1 -1
  13. package/dist/{chunk-6T6N4MRK.js → chunk-GKZRDNEB.js} +2 -2
  14. package/dist/{chunk-YSDFYHPC.js → chunk-HHXAXSG6.js} +2 -2
  15. package/dist/{chunk-2R7B7NJR.js → chunk-JU5R6JZG.js} +1 -1
  16. package/dist/{chunk-236WN6JD.js → chunk-KAEZPS3U.js} +1 -1
  17. package/dist/chunk-OP27SSZU.js +409 -0
  18. package/dist/{chunk-FQWFB54C.js → chunk-XA7U3GRN.js} +1 -1
  19. package/dist/express-assistant.d.ts +4 -3
  20. package/dist/express-assistant.js +3 -3
  21. package/dist/express.d.ts +5 -4
  22. package/dist/express.js +3 -3
  23. package/dist/history/index.d.ts +6 -5
  24. package/dist/index.d.ts +11 -10
  25. package/dist/index.js +10 -34
  26. package/dist/interactive/index.d.ts +5 -65
  27. package/dist/interactive/index.js +3 -27
  28. package/dist/interactive-BigrPKnu.d.ts +30 -0
  29. package/dist/{options-C7-VXmhD.d.ts → options-ByNm2o89.d.ts} +2 -2
  30. package/dist/{options-BcDReOJv.d.ts → options-CGUfVStV.d.ts} +1 -1
  31. package/dist/shared/index.d.ts +7 -76
  32. package/dist/shared/index.js +1 -1
  33. package/dist/socket.d.ts +6 -5
  34. package/dist/socket.js +5 -5
  35. package/dist/{types-CRWzJB5G.d.ts → types-BeGPexio.d.ts} +2 -2
  36. package/dist/{types-Crpil4kb.d.ts → types-Bz4OYEAV.d.ts} +6 -55
  37. package/docs/concepts/interactive-requests.md +7 -7
  38. package/docs/reference/boundary.md +5 -3
  39. package/docs/reference/exports.md +18 -18
  40. package/package.json +2 -2
  41. package/dist/chunk-X7ILLZZP.js +0 -1046
  42. package/dist/interactive-o_NZb-Xg.d.ts +0 -47
  43. /package/dist/{chunk-TMADMHBN.js → chunk-VBGQD6JT.js} +0 -0
@@ -4,10 +4,8 @@ Slack interactive requests render Agent Core approval and human-input requests
4
4
  as Slack buttons and modals.
5
5
 
6
6
  ```typescript
7
- import {
8
- createPostgresSlackInteractiveRequestStore,
9
- createSlackInteractiveController,
10
- } from "@cuylabs/channel-slack-agent-core/interactive";
7
+ import { createSlackInteractiveController } from "@cuylabs/channel-slack-agent-core/interactive";
8
+ import { createPostgresSlackInteractiveRequestStore } from "@cuylabs/channel-slack/interactive";
11
9
 
12
10
  const interactiveStore = createPostgresSlackInteractiveRequestStore({
13
11
  connectionString: process.env.DATABASE_URL,
@@ -30,10 +28,12 @@ const interactive = createSlackInteractiveController({
30
28
 
31
29
  ## Store Choices
32
30
 
33
- - `createInMemorySlackInteractiveRequestStore` is useful for tests and local
31
+ - `createInMemorySlackInteractiveRequestStore` from
32
+ `@cuylabs/channel-slack/interactive` is useful for tests and local
34
33
  single-process apps.
35
- - `createPostgresSlackInteractiveRequestStore` persists pending requests across
36
- restarts and lets multiple Slack workers resolve the same request safely.
34
+ - `createPostgresSlackInteractiveRequestStore` from
35
+ `@cuylabs/channel-slack/interactive` persists pending requests across restarts
36
+ and lets multiple Slack workers resolve the same request safely.
37
37
 
38
38
  The Postgres store uses one table keyed by request ID. `resolve(...)` is
39
39
  idempotent: the first resolution wins, and later duplicate button clicks return
@@ -6,16 +6,18 @@ This package owns only the `@cuylabs/agent-core` Slack binding.
6
6
 
7
7
  - Mapping Slack turns to `AgentTurnSource.chat(...)`.
8
8
  - Creating Agent Core scopes and context fragments.
9
- - Converting `AgentEvent` streams to Slack messages or chat streams.
9
+ - Converting `AgentEvent` streams through Slack response sink contracts.
10
10
  - Mounting Agent Core sources on Express Events API and Socket Mode surfaces.
11
11
  - Binding Slack Assistant lifecycle handlers to Agent Core turns.
12
- - Handling Agent Core approval and human-input requests in Slack.
12
+ - Binding Agent Core approval and human-input requests to Slack interactive
13
+ request primitives.
13
14
  - Agent Core helpers for Slack history context fragments and source events.
14
15
 
15
16
  ## Outside This Package
16
17
 
17
18
  - Generic Slack activity parsing, formatting, setup, auth, policy, history,
18
- targets, users, entrypoints, artifacts, and transport factories.
19
+ targets, users, entrypoints, artifacts, response sink contracts, interactive
20
+ request builders/stores, and transport factories.
19
21
  - Product prompts, tools, audit policy, privacy rules, and deployment policy.
20
22
  - Slack app configuration outside the reusable setup helpers.
21
23
 
@@ -3,24 +3,24 @@
3
3
  Use feature subpaths when you only need one adapter surface. Generic Slack
4
4
  primitives should be imported from `@cuylabs/channel-slack` directly.
5
5
 
6
- | Export | Depends on | Notes |
7
- | ----------------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
8
- | `@cuylabs/channel-slack-agent-core` | `@cuylabs/agent-core`, selected Slack peers | Full adapter surface re-export |
9
- | `@cuylabs/channel-slack-agent-core/adapter` | `@slack/bolt`, `@slack/web-api` types | Classic app mention, DM, and passive channel-message adapter |
10
- | `@cuylabs/channel-slack-agent-core/app` | `@slack/bolt`, `@slack/web-api` | Direct app factory for mounted Slack surfaces |
11
- | `@cuylabs/channel-slack-agent-core/app-surface` | `@slack/bolt`, `@slack/web-api` types | Shared surface installer for Assistant, mentions, DMs, feedback, and interactions |
12
- | `@cuylabs/channel-slack-agent-core/artifacts` | `@cuylabs/channel-slack/artifacts` | Agent Core final-response artifact publishers for Slack surfaces |
13
- | `@cuylabs/channel-slack-agent-core/assistant` | `@slack/bolt`, `@slack/web-api` types | Slack Assistant bridge and lifecycle handlers |
14
- | `@cuylabs/channel-slack-agent-core/express` | `@slack/bolt`, `express` | Express Events API mounting for classic Slack surfaces |
15
- | `@cuylabs/channel-slack-agent-core/express-assistant` | `@slack/bolt`, `express` | Express Events API mounting for Slack Assistant |
16
- | `@cuylabs/channel-slack-agent-core/feedback` | `@slack/bolt`, `@slack/types` | Agent Core feedback binding helpers |
17
- | `@cuylabs/channel-slack-agent-core/history` | `@slack/web-api`, `@cuylabs/agent-core` types | Agent Core turn history context fragment assembly |
18
- | `@cuylabs/channel-slack-agent-core/interactive` | `@slack/bolt`, `@slack/types`; `pg` only when using connection-string Postgres storage | Agent Core approval and human-input binding for Slack |
19
- | `@cuylabs/channel-slack-agent-core/mcp` | `@cuylabs/agent-core/mcp` types | Slack OAuth token bridge for Agent Core MCP setup |
20
- | `@cuylabs/channel-slack-agent-core/shared` | `@cuylabs/agent-core` types | Context fragments, event bridge, and interactive request contracts |
21
- | `@cuylabs/channel-slack-agent-core/socket` | `@slack/bolt` | Socket Mode mounting helpers |
22
- | `@cuylabs/channel-slack-agent-core/source` | `@cuylabs/agent-core` types | Source event queue, response helpers, and status visibility helpers |
23
- | `@cuylabs/channel-slack-agent-core/views` | `@cuylabs/channel-slack/views`, `@slack/bolt` | Agent/product Slack modal workflow controller and submitted state helpers |
6
+ | Export | Depends on | Notes |
7
+ | ----------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------- |
8
+ | `@cuylabs/channel-slack-agent-core` | `@cuylabs/agent-core`, selected Slack peers | Full adapter surface re-export |
9
+ | `@cuylabs/channel-slack-agent-core/adapter` | `@slack/bolt`, `@slack/web-api` types | Classic app mention, DM, and passive channel-message adapter |
10
+ | `@cuylabs/channel-slack-agent-core/app` | `@slack/bolt`, `@slack/web-api` | Direct app factory for mounted Slack surfaces |
11
+ | `@cuylabs/channel-slack-agent-core/app-surface` | `@slack/bolt`, `@slack/web-api` types | Shared surface installer for Assistant, mentions, DMs, feedback, and interactions |
12
+ | `@cuylabs/channel-slack-agent-core/artifacts` | `@cuylabs/channel-slack/artifacts` | Agent Core final-response artifact publishers for Slack surfaces |
13
+ | `@cuylabs/channel-slack-agent-core/assistant` | `@slack/bolt`, `@slack/web-api` types | Slack Assistant bridge and lifecycle handlers |
14
+ | `@cuylabs/channel-slack-agent-core/express` | `@slack/bolt`, `express` | Express Events API mounting for classic Slack surfaces |
15
+ | `@cuylabs/channel-slack-agent-core/express-assistant` | `@slack/bolt`, `express` | Express Events API mounting for Slack Assistant |
16
+ | `@cuylabs/channel-slack-agent-core/feedback` | `@slack/bolt`, `@slack/types` | Agent Core feedback binding helpers |
17
+ | `@cuylabs/channel-slack-agent-core/history` | `@slack/web-api`, `@cuylabs/agent-core` types | Agent Core turn history context fragment assembly |
18
+ | `@cuylabs/channel-slack-agent-core/interactive` | `@slack/bolt`, `@cuylabs/channel-slack/interactive` | Agent Core approval and human-input controller binding for Slack |
19
+ | `@cuylabs/channel-slack-agent-core/mcp` | `@cuylabs/agent-core/mcp` types | Slack OAuth token bridge for Agent Core MCP setup |
20
+ | `@cuylabs/channel-slack-agent-core/shared` | `@cuylabs/agent-core` types | Context fragments, event bridge, and Agent Core interactive request contracts |
21
+ | `@cuylabs/channel-slack-agent-core/socket` | `@slack/bolt` | Socket Mode mounting helpers |
22
+ | `@cuylabs/channel-slack-agent-core/source` | `@cuylabs/agent-core` types | Source event queue, response helpers, and status visibility helpers |
23
+ | `@cuylabs/channel-slack-agent-core/views` | `@cuylabs/channel-slack/views`, `@slack/bolt` | Agent/product Slack modal workflow controller and submitted state helpers |
24
24
 
25
25
  For generic Slack package exports, see
26
26
  `@cuylabs/channel-slack/docs/reference/exports.md`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cuylabs/channel-slack-agent-core",
3
- "version": "0.8.0",
3
+ "version": "0.9.0",
4
4
  "description": "Slack adapter for @cuylabs/agent-core built on @cuylabs/channel-slack",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -94,7 +94,7 @@
94
94
  ],
95
95
  "dependencies": {
96
96
  "@cuylabs/agent-core": "^7.2.0",
97
- "@cuylabs/channel-slack": "^0.8.0"
97
+ "@cuylabs/channel-slack": "^0.9.0"
98
98
  },
99
99
  "peerDependencies": {
100
100
  "@slack/bolt": ">=4.7.3",