@cuylabs/channel-slack-agent-core 0.5.1 → 0.6.0

package/README.md

@@ -1,15 +1,14 @@
 # @cuylabs/channel-slack-agent-core
 
-Slack adapter for `@cuylabs/agent-core`, built on `@cuylabs/channel-slack`
-primitives.
+Slack adapter for `@cuylabs/agent-core`, built on
+`@cuylabs/channel-slack`.
 
-Use this package when your agent runtime is `@cuylabs/agent-core` and you want
-ready-to-mount Slack surfaces for Bolt, Express, Socket Mode, Slack Assistant,
-classic app mentions, DMs, and in-channel interactive approval or human-input
-requests.
+Use this package when an Agent Core application needs ready-to-mount Slack
+surfaces for Express Events API, Socket Mode, Slack Assistant, app mentions,
+DMs, feedback, approvals, or human input.
 
-Use `@cuylabs/channel-slack` directly when you want Slack parsing, policy,
-history, setup, auth, or formatting primitives for another agent runtime.
+Generic Slack mechanics such as parsing, policy, history, setup, auth, targets,
+users, entrypoints, artifacts, and transports live in `@cuylabs/channel-slack`.
 
 ## Install
 
@@ -23,29 +22,9 @@ Install Slack peer dependencies for the surfaces you use:
 npm install @slack/bolt @slack/web-api express
 ```
 
-## Import Map
+## Quick Start
 
-Use feature-specific imports when you only need one adapter surface.
-
-| Import | Use for |
-| --- | --- |
-| `@cuylabs/channel-slack-agent-core/adapter` | Classic app mention, DM, and passive channel-message adapter |
-| `@cuylabs/channel-slack-agent-core/assistant` | Slack Assistant bridge and lifecycle handlers |
-| `@cuylabs/channel-slack-agent-core/express` | Express Events API mounting for classic Slack surfaces |
-| `@cuylabs/channel-slack-agent-core/express-assistant` | Express Events API mounting for Slack Assistant |
-| `@cuylabs/channel-slack-agent-core/socket` | Socket Mode mounting helpers |
-| `@cuylabs/channel-slack-agent-core/interactive` | Agent-core approval and human-input binding for Slack |
-| `@cuylabs/channel-slack-agent-core/shared` | Agent-core context fragments and event bridge plus Slack core primitives |
-| `@cuylabs/channel-slack-agent-core/bolt` | Re-exported Bolt helpers from `@cuylabs/channel-slack/bolt` |
-| `@cuylabs/channel-slack-agent-core/history` | Re-exported history helpers from `@cuylabs/channel-slack/history` |
-| `@cuylabs/channel-slack-agent-core/policy` | Re-exported message policy helpers from `@cuylabs/channel-slack/policy` |
-
-The package root re-exports the full adapter surface for compatibility and
-convenience. Reusable Slack mechanics continue to live in
-`@cuylabs/channel-slack`; this package only adds the `@cuylabs/agent-core`
-binding.
-
-## Socket Mode
+Socket Mode:
 
 ```typescript
 import { mountSlackAssistantAgentSocket } from "@cuylabs/channel-slack-agent-core";
@@ -57,7 +36,7 @@ await mountSlackAssistantAgentSocket({
 });
 ```
 
-## Express Events API
+Express Events API:
 
 ```typescript
 import { mountSlackAgent } from "@cuylabs/channel-slack-agent-core";
@@ -68,13 +47,8 @@ await mountSlackAgent(agent, {
 });
 ```
 
-## Boundary
-
-This package owns only the `@cuylabs/agent-core` binding:
-
-- mapping Slack turns to `AgentTurnSource.chat(...)`
-- creating agent-core scopes and context fragments
-- converting `AgentEvent` streams to Slack messages or chat streams
-- handling agent-core approval and human-input requests in Slack
+## Documentation
 
-Reusable Slack mechanics live in `@cuylabs/channel-slack`.
+- [Package boundary](docs/reference/boundary.md)
+- [Exports and peer expectations](docs/reference/exports.md)
+- [Docs index](docs/README.md)

package/dist/{adapter.d.ts → adapter/index.d.ts}

@@ -1,10 +1,9 @@
-export { c as createSlackChannelAdapter } from './adapter-Cmd2C90g.js';
-import { a as SlackChannelOptions } from './types-BqRzb_Cd.js';
-export { S as SlackChannelAdapter, b as SlackSessionStrategy, c as SlackStreamingMode, d as SlackToolStartEvent } from './types-BqRzb_Cd.js';
+export { c as createSlackChannelAdapter } from '../adapter-Cmd2C90g.js';
+import { a as SlackChannelOptions } from '../types-BqRzb_Cd.js';
+export { S as SlackChannelAdapter, b as SlackSessionStrategy, c as SlackStreamingMode, d as SlackToolStartEvent } from '../types-BqRzb_Cd.js';
 import { SlackActivityInfo } from '@cuylabs/channel-slack/core';
-export { resolveThreadAwareSlackSessionId } from '@cuylabs/channel-slack/core';
 import '@cuylabs/agent-core';
-import './interactive-o_NZb-Xg.js';
+import '../interactive-o_NZb-Xg.js';
 
 /**
  * Session mapping — Slack activity info to agent-core session IDs.

package/dist/adapter/index.js

@@ -0,0 +1,9 @@
+import {
+  createSlackChannelAdapter,
+  createSlackSessionMap
+} from "../chunk-TIQGJ52F.js";
+import "../chunk-NOVWLAVP.js";
+export {
+  createSlackChannelAdapter,
+  createSlackSessionMap
+};

package/dist/app-surface.js

@@ -1,12 +1,10 @@
 import {
   installSlackAgentAppSurface
-} from "./chunk-M64Z6TYL.js";
-import "./chunk-BFUPAJON.js";
-import "./chunk-VHGV66M7.js";
-import "./chunk-FDRQOG7Q.js";
-import "./chunk-GNXWTKQ6.js";
-import "./chunk-DHPD4XH5.js";
-import "./chunk-I2KLQ2HA.js";
+} from "./chunk-P7KK5GQG.js";
+import "./chunk-ZDVD46RT.js";
+import "./chunk-ELR6MQD7.js";
+import "./chunk-TIQGJ52F.js";
+import "./chunk-NOVWLAVP.js";
 export {
   installSlackAgentAppSurface
 };

package/dist/app.d.ts

@@ -1,7 +1,8 @@
 import { Server } from 'node:http';
 import { Application } from 'express';
 import { App, ExpressReceiver } from '@slack/bolt';
-import { CreateSlackBoltAppOptions, SlackDirectAuthOptions, SlackDirectAuthMode } from '@cuylabs/channel-slack/bolt';
+import { CreateSlackBoltAppOptions } from '@cuylabs/channel-slack/transports/http';
+import { SlackDirectAuthOptions, SlackDirectAuthMode } from '@cuylabs/channel-slack/auth';
 import { SlackAgentAppSurfaceOptions } from './app-surface.js';
 export { MountSlackAgentAppTurnRequestContext } from './app-surface.js';
 import { S as SlackAssistantBridge } from './options-Uf-qmQKN.js';

package/dist/app.js

@@ -1,14 +1,11 @@
 import {
   mountSlackAgentApp
-} from "./chunk-CYEBGC6G.js";
-import "./chunk-M64Z6TYL.js";
-import "./chunk-BFUPAJON.js";
-import "./chunk-VHGV66M7.js";
-import "./chunk-FDRQOG7Q.js";
-import "./chunk-GNXWTKQ6.js";
-import "./chunk-DHPD4XH5.js";
-import "./chunk-ANIZ5NT4.js";
-import "./chunk-I2KLQ2HA.js";
+} from "./chunk-FNT4TXNQ.js";
+import "./chunk-P7KK5GQG.js";
+import "./chunk-ZDVD46RT.js";
+import "./chunk-ELR6MQD7.js";
+import "./chunk-TIQGJ52F.js";
+import "./chunk-NOVWLAVP.js";
 export {
   mountSlackAgentApp
 };

package/dist/{assistant.d.ts → assistant/index.d.ts}

@@ -1,12 +1,12 @@
-import { C as CreateSlackAssistantBridgeOptions, S as SlackAssistantBridge } from './options-Uf-qmQKN.js';
-export { A as AssistantLifecycleArgs, a as AssistantThreadStartedArgs, M as MaybePromise, b as SlackAssistantFeedbackConfig, c as SlackAssistantSessionStrategy, d as SlackAssistantStatusContext, e as SlackAssistantThreadContextStoreLike, f as SlackAssistantThreadStartedContext, g as SlackAssistantTurnPreparation, h as SlackAssistantUserMessageContext, r as resolveAssistantSessionId } from './options-Uf-qmQKN.js';
+import { C as CreateSlackAssistantBridgeOptions, S as SlackAssistantBridge } from '../options-Uf-qmQKN.js';
+export { A as AssistantLifecycleArgs, a as AssistantThreadStartedArgs, M as MaybePromise, b as SlackAssistantFeedbackConfig, c as SlackAssistantSessionStrategy, d as SlackAssistantStatusContext, e as SlackAssistantThreadContextStoreLike, f as SlackAssistantThreadStartedContext, g as SlackAssistantTurnPreparation, h as SlackAssistantUserMessageContext, r as resolveAssistantSessionId } from '../options-Uf-qmQKN.js';
 export { ParsedAssistantUserMessage, createSlackAssistantThreadContextStore, parseSlackMessageActivityFromMessageEvent } from '@cuylabs/channel-slack/assistant';
 import '@cuylabs/agent-core';
 import '@slack/bolt';
 import '@slack/web-api';
 import '@cuylabs/channel-slack/core';
-import './interactive-o_NZb-Xg.js';
-import './options-C7OYeNR-.js';
+import '../interactive-o_NZb-Xg.js';
+import '../options-C7OYeNR-.js';
 import '@cuylabs/channel-slack/feedback';
 
 /**

package/dist/{assistant.js → assistant/index.js}

@@ -3,11 +3,9 @@ import {
   createSlackAssistantThreadContextStore,
   parseSlackMessageActivityFromMessageEvent,
   resolveAssistantSessionId
-} from "./chunk-BFUPAJON.js";
-import "./chunk-VHGV66M7.js";
-import "./chunk-GNXWTKQ6.js";
-import "./chunk-DHPD4XH5.js";
-import "./chunk-I2KLQ2HA.js";
+} from "../chunk-ZDVD46RT.js";
+import "../chunk-ELR6MQD7.js";
+import "../chunk-NOVWLAVP.js";
 export {
   createSlackAssistantBridge,
   createSlackAssistantThreadContextStore,

package/dist/{chunk-JMLB7A2V.js → chunk-5NQYLOAW.js}

@@ -1,11 +1,11 @@
 import {
   createSlackAssistantBridge
-} from "./chunk-BFUPAJON.js";
-import {
-  bolt_exports
-} from "./chunk-ANIZ5NT4.js";
+} from "./chunk-ZDVD46RT.js";
 
 // src/express-assistant.ts
+import {
+  createSlackBoltApp
+} from "@cuylabs/channel-slack/transports/http";
 async function mountSlackAssistantAgent(options) {
   const {
     botToken,
@@ -29,7 +29,7 @@ async function mountSlackAssistantAgent(options) {
     app: expressApp,
     authMode,
     routePath
-  } = await (0, bolt_exports.createSlackBoltApp)({
+  } = await createSlackBoltApp({
     signingSecret,
     path,
     botToken,

package/dist/{chunk-NIPAN4KA.js → chunk-A2PLAVW6.js}

@@ -1,8 +1,7 @@
+// src/shared/context-fragments.ts
 import {
   currentSlackTurnContext
-} from "./chunk-DHPD4XH5.js";
-
-// src/shared/context-fragments.ts
+} from "@cuylabs/channel-slack/core";
 var DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY = "slackContextFragment";
 function isRecord(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);