@eliya-oss/agent-slack 0.1.12 → 0.1.13

package/.agents/cli-api.md

@@ -22,7 +22,8 @@ Non-goal for v0: agent-side summarization. The CLI returns clean context; agents
 ## Global Flags
 
 ```bash
-agent-slack [--profile NAME] [--team TEAM_ID] [--token user|bot|admin|app]
+agent-slack [--version] [--help]
+    [--profile NAME] [--team TEAM_ID] [--token user|bot|admin|app]
     [--json] [--format json|ndjson|table] [--pretty] [--full]
     [--fields FIELD[,FIELD...]]
     [--limit N] [--cursor CURSOR] [--all]
@@ -35,6 +36,7 @@ Defaults:
 - `--token user` for user-visible data.
 - `--format json` when stdout is not a TTY.
 - `--limit` uses Slack's method default unless a command defines a smaller agent-safe default.
+- `--version` prints the CLI version as a bare line and exits `0`. `--help` prints the command catalog.
 
 ## Auth
 
@@ -116,6 +118,8 @@ agent-slack conversation context CHANNEL_ID [--since 24h] [--include users,threa
 
 `conversation context` returns normalized messages, hydrated users, thread refs, file refs, reactions, and permalinks in one deterministic payload for agents.
 
+`conversation list`, `conversation history`, and `conversation context` accept `--all` to auto-paginate every page, plus `--types`/`--limit` where relevant. These flags are advertised in `describe --json` and `<command> --help` so agents can discover them; without `--all` a large list returns only the first page with `paging.has_more: true`.
+
 ### Threads and messages
 
 ```bash
@@ -240,6 +244,17 @@ NDJSON streaming record:
 {"ok":true,"type":"slack.message","team_id":"T123","channel_id":"C123","ts":"1710000000.000100","data":{}}
 ```
 
+NDJSON enrichment records: when `--include` is combined with `--format ndjson`,
+the hydration maps that `--json` returns under `data.users`/`data.threads`/`data.permalinks`
+are streamed as typed records after the message lines, so the streaming mode is
+not lossy. Message lines stay bare; enrichment lines carry a `type`:
+
+```json
+{"type":"slack.user","data":{"id":"U123","name":"ada","real_name":"Ada"}}
+{"type":"slack.thread","data":{"ts":"1710000000.000100","replies":[]}}
+{"type":"slack.permalink","data":{"ts":"1710000000.000100","permalink":"https://slack.com/..."}}
+```
+
 Structured error on stderr:
 
 ```json

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @eliya-oss/agent-slack
 
+## 0.1.13
+
+### Patch Changes
+
+- 48d5879: Three CLI fixes for agents.
+
+  - `agent-slack --version` now prints the version and exits 0 instead of raising a usage error.
+  - `conversation list`, `conversation history`, and `conversation context` now advertise their pagination flags (`--all`, `--types`, `--limit`) in `describe --json` and `--help`, so agents can discover `--all` instead of only getting the first page.
+  - `--include users,threads,permalinks` now works with `--format ndjson`: the hydrated users, threads, and permalinks are streamed as typed records (`slack.user`, `slack.thread`, `slack.permalink`) after the message lines. Previously they were only present with `--json` and silently dropped in ndjson.
+
 ## 0.1.12
 
 ### Patch Changes

package/dist/main.js

@@ -25105,6 +25105,7 @@ const booleanFlags = /* @__PURE__ */ new Set([
 	"all",
 	"allow-write",
 	"help",
+	"version",
 	"json",
 	"no-color",
 	"raw",
@@ -25523,7 +25524,7 @@ const truncate = (value, width) => value.length > width ? `${value.slice(0, Math
 //#endregion
 //#region src/cli/metadata.ts
 createRequire(import.meta.url);
-const packageJson = { version: "0.1.12" };
+const packageJson = { version: "0.1.13" };
 const PRIMARY_COMMAND_NAME = "agent-slack";
 const SHORT_COMMAND_NAME = "aslk";
 const COMMAND_NAMES = [PRIMARY_COMMAND_NAME, SHORT_COMMAND_NAME];
@@ -25764,6 +25765,12 @@ const commandMetadata = [
 	{
 		path: ["conversation", "list"],
 		summary: "List conversations visible to the active profile.",
+		flags: [
+			"--types",
+			"--limit",
+			"--all",
+			"--json"
+		],
 		methods: ["conversations.list"],
 		scopes: [
 			"channels:read",
@@ -25773,12 +25780,21 @@ const commandMetadata = [
 		],
 		safety: "read",
 		output: "conversation list",
-		examples: ["agent-slack conversation list --types public_channel,private_channel --json"]
+		examples: ["agent-slack conversation list --types public_channel,private_channel --json", "agent-slack conversation list --all --json"]
 	},
 	{
 		path: ["conversation", "history"],
 		summary: "Read conversation history.",
 		args: ["CHANNEL_ID"],
+		flags: [
+			"--oldest",
+			"--latest",
+			"--since",
+			"--inclusive",
+			"--limit",
+			"--all",
+			"--json"
+		],
 		methods: ["conversations.history"],
 		scopes: [
 			"channels:history",
@@ -25794,6 +25810,15 @@ const commandMetadata = [
 		path: ["conversation", "context"],
 		summary: "Build channel context for agents.",
 		args: ["CHANNEL_ID"],
+		flags: [
+			"--since",
+			"--include",
+			"--limit",
+			"--all",
+			"--full",
+			"--format",
+			"--json"
+		],
 		methods: [
 			"conversations.history",
 			"conversations.replies",
@@ -25911,6 +25936,7 @@ const renderHumanHelp = (path) => {
 		command.summary,
 		"",
 		command.args === void 0 ? "" : `Usage: ${PRIMARY_COMMAND_NAME} ${command.path.join(" ")} ${command.args.join(" ")}`,
+		command.flags === void 0 ? "" : `Flags: ${command.flags.join(" ")}`,
 		command.scopes === void 0 ? "" : `Scopes: ${command.scopes.join(", ")}`,
 		"",
 		"Examples:",
@@ -26249,6 +26275,12 @@ const extractItems = (services, method, response) => {
 const dispatch = async (parsed, services) => {
 	const pos = parsed.positionals;
 	const [first, second, third] = pos;
+	if (flagBoolean(parsed, "version")) return {
+		method: "version",
+		profile: null,
+		stdoutValue: null,
+		rawStdout: `${CLI_VERSION}\n`
+	};
 	if (flagBoolean(parsed, "help") && !flagBoolean(parsed, "json")) return {
 		method: "help",
 		profile: null,
@@ -26656,6 +26688,26 @@ const conversationContext = async (parsed, services) => {
 		response: history.response,
 		stdoutValue: context,
 		items: messages.map(shape),
+		enrichmentRecords: [
+			...recordsFromMap(context.users, (_, data) => ({
+				type: "slack.user",
+				data
+			})),
+			...recordsFromMap(context.threads, (ts, replies) => ({
+				type: "slack.thread",
+				data: {
+					ts,
+					replies
+				}
+			})),
+			...recordsFromMap(context.permalinks, (ts, permalink) => ({
+				type: "slack.permalink",
+				data: {
+					ts,
+					permalink
+				}
+			}))
+		],
 		...warnings.length > 0 ? { warnings } : {}
 	};
 };
@@ -26736,6 +26788,16 @@ const threadGet = async (parsed, services) => {
 		response: result.response,
 		stdoutValue: data,
 		items: rawMessages.map(shape),
+		enrichmentRecords: [...recordsFromMap(data.users, (_, user) => ({
+			type: "slack.user",
+			data: user
+		})), ...recordsFromMap(data.permalinks, (ts, permalink) => ({
+			type: "slack.permalink",
+			data: {
+				ts,
+				permalink
+			}
+		}))],
 		...warnings.length > 0 ? { warnings } : {}
 	};
 };
@@ -26844,7 +26906,7 @@ const methodCall = async (parsed, services, input, options = {}) => {
 };
 const renderDispatchResult = (parsed, result, options = {}) => {
 	if (result.rawStdout !== void 0) return result.rawStdout;
-	if (flagString(parsed, "format") === "ndjson") return toNdjson(result.items ?? []);
+	if (flagString(parsed, "format") === "ndjson") return toNdjson([...result.items ?? [], ...result.enrichmentRecords ?? []]);
 	const data = projectFields(result.stdoutValue, flagString(parsed, "fields"));
 	const envelope = successEnvelope({
 		method: result.method,
@@ -26901,6 +26963,7 @@ const stringField = (record, name) => typeof record[name] === "string" && record
 const extractArray = (value) => Array.isArray(value) ? value : [];
 const extractLooseRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
 const uniqueStrings = (values) => [...new Set(values.filter((value) => value !== void 0))];
+const recordsFromMap = (value, toRecord) => Object.entries(extractLooseRecord(value)).map(([key, entry]) => toRecord(key, entry));
 //#endregion
 //#region src/application/execute.ts
 const executeCli = async (argv, services, options = {}) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eliya-oss/agent-slack",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "Slack context CLI for AI agents.",
   "type": "module",
   "bin": {