@eliya-oss/agent-slack 0.1.0

package/dist/output/projection.js

@@ -0,0 +1,55 @@
+import { UsageError } from "../domain/errors.js";
+export const projectFields = (value, fields) => {
+    if (fields === undefined || fields.trim() === "") {
+        return value;
+    }
+    const paths = fields.split(",").map((field) => field.trim()).filter(Boolean);
+    if (paths.length === 0) {
+        return value;
+    }
+    const projected = {};
+    for (const path of paths) {
+        assignPath(projected, path, readPath(value, path));
+    }
+    return projected;
+};
+const readPath = (value, path) => {
+    let current = value;
+    for (const segment of path.split(".")) {
+        if (segment === "") {
+            throw new UsageError("--fields paths cannot contain empty segments", { path });
+        }
+        if (Array.isArray(current)) {
+            const index = Number(segment);
+            if (!Number.isInteger(index) || index < 0) {
+                return undefined;
+            }
+            current = current[index];
+            continue;
+        }
+        if (typeof current !== "object" || current === null || !(segment in current)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+};
+const assignPath = (target, path, value) => {
+    const segments = path.split(".");
+    let current = target;
+    for (const segment of segments.slice(0, -1)) {
+        const next = current[segment];
+        if (typeof next === "object" && next !== null && !Array.isArray(next)) {
+            current = next;
+            continue;
+        }
+        const created = {};
+        current[segment] = created;
+        current = created;
+    }
+    const last = segments.at(-1);
+    if (last === undefined || last === "") {
+        throw new UsageError("--fields paths cannot contain empty segments", { path });
+    }
+    current[last] = value;
+};

package/dist/ports/FileDownloader.js

@@ -0,0 +1 @@
+export {};

package/dist/ports/MethodCatalog.js

@@ -0,0 +1 @@
+export {};

package/dist/ports/OAuthFlow.js

@@ -0,0 +1 @@
+export {};

package/dist/ports/SlackWebApi.js

@@ -0,0 +1 @@
+export {};

package/dist/ports/TokenStore.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@eliya-oss/agent-slack",
+  "version": "0.1.0",
+  "description": "Slack context CLI for AI agents.",
+  "type": "module",
+  "packageManager": "pnpm@11.9.0",
+  "bin": {
+    "slk": "dist/main.js"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "skills",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    ".agents/cli-api.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "pnpm typecheck && pnpm test:coverage && pnpm build",
+    "changeset": "changeset",
+    "clean": "rm -rf dist coverage",
+    "dev": "tsx src/main.ts",
+    "prepack": "pnpm build",
+    "release:check": "pnpm check && npm pack --dry-run",
+    "slk": "tsx src/main.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:emulate": "vitest run tests/emulate",
+    "version-packages": "changeset version"
+  },
+  "keywords": [
+    "slack",
+    "cli",
+    "agents",
+    "effect",
+    "oauth"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@effect/platform-node": "4.0.0-beta.93",
+    "@slack/web-api": "7.18.0",
+    "effect": "4.0.0-beta.93"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.0",
+    "@effect/vitest": "4.0.0-beta.93",
+    "@types/node": "latest",
+    "@vitest/coverage-v8": "^4.1.9",
+    "emulate": "^0.8.0",
+    "tsx": "latest",
+    "typescript": "latest",
+    "vitest": "latest"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/skills/agent-slack/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: agent-slack
+description: "Use when Codex needs Slack context through the `slk` CLI: authenticate, inspect profiles/scopes, read channels, messages, threads, files, users, search context, or call Slack Web API methods with agent-readable JSON or NDJSON output."
+---
+
+# slk CLI
+
+Use `slk` as the Slack context boundary. Prefer read-only commands and preserve Slack's permission model: the CLI can only return data allowed by the active token, scopes, channel membership, workspace policy, and Slack plan.
+
+## Workflow
+
+1. Check availability: `slk describe --json`.
+2. Check auth: `slk auth status --json`.
+3. If auth is missing, ask the user to run OAuth or provide a seeded profile; do not invent credentials.
+4. Use specific read commands before raw API calls.
+5. Use `--json` for bounded results and `--format ndjson` for large context streams.
+6. Read structured errors from stderr; do not parse progress text from stdout.
+
+## Common Commands
+
+```bash
+slk conversation history C123 --limit 50 --json
+slk thread get --channel C123 --ts 1710000000.000100 --include users,permalinks --json
+slk conversation context C123 --include users,threads,permalinks --format ndjson
+slk file download F123 --out ./artifact.bin --json
+slk user get U123 --json
+slk api call conversations.info --payload '{"channel":"C123"}' --json
+```
+
+## Safety
+
+- Treat `slk api call` as the escape hatch for missing wrappers.
+- Do not pass write/admin-mutating Slack methods unless the user explicitly asks for mutation and accepts `--allow-write --yes`.
+- Never print token values. `auth status` reports token presence and scopes without secrets.
+- For local repo development, use `pnpm slk -- ...` from the repository root instead of global `slk`.

package/skills/agent-slack/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Slack CLI"
+  short_description: "Use slk to retrieve Slack context"
+  default_prompt: "Use $agent-slack to retrieve Slack channel or thread context with the slk CLI."