@cuylabs/channel-slack 0.1.0

package/docs/reference/exports.md

@@ -0,0 +1,32 @@
+# Exports
+
+Use feature subpaths for new code. They make dependency expectations clearer and
+keep application code close to the package boundary it uses.
+
+| Export | Depends on | Notes |
+| --- | --- | --- |
+| `@cuylabs/channel-slack/core` | no Slack SDK runtime imports | Transport-neutral parsing, formatting, types, sessions, turn context |
+| `@cuylabs/channel-slack/shared` | no Slack SDK runtime imports | Compatibility alias for `core` |
+| `@cuylabs/channel-slack/policy` | no Slack SDK runtime imports | Message admission and policy state |
+| `@cuylabs/channel-slack/history` | `@slack/web-api` types | History reader accepts a Slack WebClient or minimal conversations client |
+| `@cuylabs/channel-slack/bolt` | `@slack/bolt`, `express` | Bolt app factories and Socket Mode runtime helpers |
+| `@cuylabs/channel-slack/setup` | diagnostics only when inspecting live tokens | Setup requirements and app manifest helpers |
+| `@cuylabs/channel-slack/diagnostics` | `@slack/web-api` | Token, auth, and scope inspection |
+| `@cuylabs/channel-slack/users` | `@slack/web-api` when using default client | User profile lookup and mention enrichment |
+| `@cuylabs/channel-slack/targets` | no Slack SDK runtime imports unless resolving names through a client | Parse and resolve channel/user targets |
+| `@cuylabs/channel-slack/feedback` | `@slack/types` types | Feedback block and action helpers |
+
+The root export remains available for lightweight core and policy helpers:
+
+```typescript
+import {
+  createSlackMessagePolicyResolver,
+  parseSlackMentionActivity,
+} from "@cuylabs/channel-slack";
+```
+
+Prefer feature-specific imports for anything outside core parsing, formatting,
+session helpers, and message policy.
+
+For package-boundary context, see
+[Channel Slack Boundary](channel-slack-boundary.md).

package/package.json

@@ -0,0 +1,130 @@
+{
+  "name": "@cuylabs/channel-slack",
+  "version": "0.1.0",
+  "description": "SDK-neutral Slack channel primitives for AI agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./assistant": {
+      "types": "./dist/assistant.d.ts",
+      "import": "./dist/assistant.js",
+      "default": "./dist/assistant.js"
+    },
+    "./bolt": {
+      "types": "./dist/bolt.d.ts",
+      "import": "./dist/bolt.js",
+      "default": "./dist/bolt.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js",
+      "default": "./dist/core.js"
+    },
+    "./diagnostics": {
+      "types": "./dist/diagnostics.d.ts",
+      "import": "./dist/diagnostics.js",
+      "default": "./dist/diagnostics.js"
+    },
+    "./feedback": {
+      "types": "./dist/feedback.d.ts",
+      "import": "./dist/feedback.js",
+      "default": "./dist/feedback.js"
+    },
+    "./history": {
+      "types": "./dist/history.d.ts",
+      "import": "./dist/history.js",
+      "default": "./dist/history.js"
+    },
+    "./policy": {
+      "types": "./dist/policy.d.ts",
+      "import": "./dist/policy.js",
+      "default": "./dist/policy.js"
+    },
+    "./setup": {
+      "types": "./dist/setup.d.ts",
+      "import": "./dist/setup.js",
+      "default": "./dist/setup.js"
+    },
+    "./shared": {
+      "types": "./dist/shared.d.ts",
+      "import": "./dist/shared.js",
+      "default": "./dist/shared.js"
+    },
+    "./targets": {
+      "types": "./dist/targets.d.ts",
+      "import": "./dist/targets.js",
+      "default": "./dist/targets.js"
+    },
+    "./users": {
+      "types": "./dist/users.d.ts",
+      "import": "./dist/users.js",
+      "default": "./dist/users.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@slack/bolt": ">=4.7.3",
+    "@slack/types": ">=2.21.1",
+    "@slack/web-api": ">=7.16.0",
+    "express": ">=4.21.0 || >=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@slack/bolt": {
+      "optional": true
+    },
+    "@slack/types": {
+      "optional": true
+    },
+    "@slack/web-api": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@slack/bolt": "^4.7.3",
+    "@slack/types": "^2.21.1",
+    "@slack/web-api": "^7.16.0",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "express": "^5.2.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "slack",
+    "channel",
+    "adapter",
+    "bolt"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/core.ts src/shared.ts src/assistant.ts src/bolt.ts src/diagnostics.ts src/feedback.ts src/history.ts src/policy.ts src/setup.ts src/targets.ts src/users.ts --format esm --dts --clean",
+    "clean": "rm -rf dist",
+    "dev": "tsup src/index.ts src/core.ts src/shared.ts src/assistant.ts src/bolt.ts src/diagnostics.ts src/feedback.ts src/history.ts src/policy.ts src/setup.ts src/targets.ts src/users.ts --format esm --dts --watch",
+    "lint": "eslint \"src/**/*.{ts,tsx}\" \"tests/**/*.{ts,tsx}\" --max-warnings=0",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}