@eliya-oss/agent-slack 0.1.10 → 0.1.12

package/dist/output/envelope.js

@@ -1,62 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { isSlkError, normalizeUnknownError } from "../domain/errors.js";
-export const pagingFrom = (response) => {
-    const metadata = response.response_metadata;
-    const nextCursor = typeof metadata === "object" && metadata !== null && "next_cursor" in metadata
-        ? metadata.next_cursor
-        : undefined;
-    return {
-        next_cursor: typeof nextCursor === "string" && nextCursor.length > 0 ? nextCursor : null,
-        has_more: response.has_more === true || (typeof nextCursor === "string" && nextCursor.length > 0)
-    };
-};
-export const successEnvelope = (input) => ({
-    ok: true,
-    method: input.method,
-    team_id: input.profile?.teamId ?? null,
-    enterprise_id: input.profile?.enterpriseId ?? null,
-    profile: input.profile?.name ?? null,
-    data: input.data,
-    paging: input.paging ?? { next_cursor: null, has_more: false },
-    warnings: input.warnings ?? []
-});
-export const errorEnvelope = (error) => {
-    const normalized = normalizeUnknownError(error);
-    const details = Object.fromEntries(Object.entries(normalized.details).filter(([key]) => key !== "suggestion"));
-    const detailsSlackError = typeof details.slackError === "string" ? details.slackError : undefined;
-    const slackError = "slackError" in normalized ? normalized.slackError ?? detailsSlackError : detailsSlackError;
-    const retryAfterSeconds = "retryAfterSeconds" in normalized ? normalized.retryAfterSeconds : undefined;
-    const detailSuggestion = typeof normalized.details.suggestion === "string" ? normalized.details.suggestion : undefined;
-    const suggestion = detailSuggestion ?? suggestionFor(normalized._tag);
-    const envelope = {
-        ok: false,
-        error: {
-            type: normalized._tag,
-            title: normalized.message,
-            ...(slackError === undefined ? {} : { slack_error: slackError }),
-            retriable: normalized._tag === "SlackRateLimited",
-            ...(retryAfterSeconds === undefined ? {} : { retry_after_seconds: retryAfterSeconds }),
-            ...(suggestion === undefined ? {} : { suggestion }),
-            trace_id: `slk_${randomUUID()}`,
-            ...(Object.keys(details).length === 0 ? {} : { details })
-        }
-    };
-    return { envelope, exitCode: normalized.exitCode };
-};
-const suggestionFor = (tag) => {
-    switch (tag) {
-        case "NotAuthenticated":
-            return "Run agent-slack auth login, or use --token with an existing Slack bot token.";
-        case "MissingScope":
-            return "Reinstall or reauthorize the Slack app with the missing scope.";
-        case "SlackRateLimited":
-            return "Retry after the provided delay or reduce page size.";
-        case "UnsafeMethodBlocked":
-            return "Pass --allow-write --yes only when the operator intentionally allows this call.";
-        default:
-            return undefined;
-    }
-};
-export const stringifyJson = (value) => `${JSON.stringify(value, null, 2)}\n`;
-export const toNdjson = (items) => items.map((item) => JSON.stringify(item)).join("\n") + (items.length > 0 ? "\n" : "");
-export const exitCodeOf = (error) => isSlkError(error) ? error.exitCode : 1;

package/dist/output/human.js

@@ -1,302 +0,0 @@
-const codes = {
-    bold: [1, 22],
-    cyan: [36, 39],
-    dim: [2, 22],
-    green: [32, 39],
-    red: [31, 39],
-    yellow: [33, 39]
-};
-export const renderHumanEnvelope = (envelope, options) => {
-    const paint = (name, value) => options.color ? `\u001b[${codes[name][0]}m${value}\u001b[${codes[name][1]}m` : value;
-    if (isCommandCatalog(envelope.data)) {
-        return `${renderCommandCatalog(envelope.data, paint).join("\n")}\n`;
-    }
-    const metadata = renderMetadata(envelope, paint);
-    const warnings = envelope.warnings.map((warning) => `${paint("yellow", "Warning")}: ${warning}`);
-    const data = renderHumanData(envelope.data, paint);
-    const lines = [
-        `${paint("green", "OK")} ${paint("bold", envelope.method)}`,
-        ...(metadata === "" ? [] : [metadata]),
-        ...(warnings.length === 0 ? [] : warnings),
-        ...(data.length === 0 ? [] : ["", ...data])
-    ];
-    return `${lines.join("\n")}\n`;
-};
-export const renderHumanErrorEnvelope = (envelope, options) => {
-    const paint = (name, value) => options.color ? `\u001b[${codes[name][0]}m${value}\u001b[${codes[name][1]}m` : value;
-    const error = envelope.error;
-    const lines = [
-        `${paint("red", "Error")} ${paint("bold", error.type)}`,
-        error.title,
-        ...(error.slack_error === undefined ? [] : ["", `${paint("dim", "Slack")} ${error.slack_error}`]),
-        ...(error.retry_after_seconds === undefined ? [] : [`${paint("dim", "Retry after")} ${error.retry_after_seconds}s`]),
-        ...(error.suggestion === undefined ? [] : ["", paint("yellow", "Next"), `  ${error.suggestion}`]),
-        "",
-        `${paint("dim", "Trace")} ${error.trace_id}`
-    ];
-    return `${lines.join("\n")}\n`;
-};
-const isCommandCatalog = (value) => {
-    if (!isRecord(value) || typeof value.name !== "string" || !Array.isArray(value.commands)) {
-        return false;
-    }
-    return value.commands.every((command) => isRecord(command) &&
-        Array.isArray(command.path) &&
-        command.path.every((part) => typeof part === "string") &&
-        typeof command.summary === "string");
-};
-const renderCommandCatalog = (catalog, paint) => {
-    const title = catalog.version === undefined ? `${titleCase(catalog.name)} Commands` : "Agent Slack";
-    const aliases = catalog.aliases?.join(", ");
-    const groups = groupCommands(catalog.commands);
-    return [
-        `${paint("bold", title)}${catalog.version === undefined ? "" : ` ${paint("dim", catalog.version)}`}`,
-        paint("dim", "Slack context CLI for agents"),
-        "",
-        `${paint("dim", "Use")}     ${paint("cyan", `${catalog.name} <command> [--json]`)}`,
-        ...(aliases === undefined ? [] : [`${paint("dim", "Alias")}   ${aliases}`]),
-        `${paint("dim", "Output")}  readable in terminals; JSON for pipes and --json`,
-        "",
-        ...groups.flatMap((group) => renderCommandGroup(group, paint)),
-        "",
-        paint("dim", `Run ${catalog.name} <command> --help for details.`)
-    ];
-};
-const renderCommandGroup = (group, paint) => {
-    return [
-        paint("yellow", group.title),
-        ...group.commands.map((command) => {
-            const safety = command.safety === "destructive"
-                ? ` ${paint("yellow", "[destructive]")}`
-                : command.safety === "unknown"
-                    ? ` ${paint("yellow", "[review]")}`
-                    : "";
-            return `  ${paint("cyan", commandSignature(command))} - ${command.summary}${safety}`;
-        }),
-        ""
-    ];
-};
-const groupCommands = (commands) => {
-    const groups = new Map();
-    for (const command of commands) {
-        const key = groupKey(command);
-        groups.set(key, [...(groups.get(key) ?? []), command]);
-    }
-    return commandGroupOrder
-        .map((group) => ({
-        ...group,
-        commands: groups.get(group.key) ?? []
-    }))
-        .filter((group) => group.commands.length > 0);
-};
-const commandGroupOrder = [
-    { key: "system", title: "System" },
-    { key: "auth", title: "Auth" },
-    { key: "workspace", title: "Workspace" },
-    { key: "people", title: "People" },
-    { key: "conversations", title: "Conversations" },
-    { key: "search", title: "Search" },
-    { key: "files", title: "Files" },
-    { key: "surfaces", title: "Slack Objects" },
-    { key: "api", title: "Web API" }
-];
-const groupKey = (command) => {
-    const root = command.path[0];
-    if (root === "describe" || root === "completion") {
-        return "system";
-    }
-    if (root === "team" || root === "enterprise") {
-        return "workspace";
-    }
-    if (root === "user" || root === "usergroups") {
-        return "people";
-    }
-    if (root === "conversation" || root === "thread" || root === "message") {
-        return "conversations";
-    }
-    if (root === "file") {
-        return "files";
-    }
-    if (root === "reaction" || root === "pin" || root === "bookmark" || root === "emoji" || root === "dnd") {
-        return "surfaces";
-    }
-    return root ?? "system";
-};
-const commandSignature = (command) => {
-    const args = command.args?.filter((arg) => arg !== "PAYLOAD_STDIN_MARKER").join(" ");
-    return [command.path.join(" "), args].filter((part) => part !== undefined && part !== "").join(" ");
-};
-const renderMetadata = (envelope, paint) => {
-    const parts = [
-        envelope.profile === null ? undefined : `profile ${envelope.profile}`,
-        envelope.team_id === null ? undefined : `team ${envelope.team_id}`,
-        envelope.enterprise_id === null ? undefined : `enterprise ${envelope.enterprise_id}`,
-        envelope.paging.has_more ? `next ${envelope.paging.next_cursor ?? "cursor"}` : undefined
-    ].filter((part) => part !== undefined);
-    return parts.length === 0 ? "" : paint("dim", parts.join(" | "));
-};
-const renderHumanData = (value, paint) => {
-    if (Array.isArray(value)) {
-        return renderArray(value, paint);
-    }
-    if (isRecord(value)) {
-        const primaryArray = findPrimaryArray(value);
-        const excludedKeys = new Set(primaryArray === null ? [] : [primaryArray.key]);
-        const fieldLines = renderFields(value, excludedKeys, paint);
-        const hasComplexValues = hasVisibleComplexValues(value, excludedKeys);
-        if (primaryArray !== null) {
-            return [
-                ...fieldLines,
-                fieldLines.length === 0 ? "" : "",
-                `${paint("cyan", labelFor(primaryArray.key))} (${primaryArray.items.length})`,
-                ...renderArray(primaryArray.items, paint)
-            ].filter((line) => line !== "");
-        }
-        if (fieldLines.length > 0 && !hasComplexValues) {
-            return fieldLines;
-        }
-    }
-    return ["data:", indent(JSON.stringify(value, null, 2))];
-};
-const findPrimaryArray = (record) => {
-    const preferred = ["messages", "members", "channels", "files", "users", "results", "items"];
-    for (const key of preferred) {
-        const value = record[key];
-        if (Array.isArray(value) && !value.every(isScalar)) {
-            return { key, items: value };
-        }
-    }
-    for (const [key, value] of Object.entries(record)) {
-        if (Array.isArray(value) && !value.every(isScalar)) {
-            return { key, items: value };
-        }
-    }
-    return null;
-};
-const renderFields = (record, excludedKeys, paint) => {
-    const entries = Object.entries(record)
-        .filter(([key, value]) => !excludedKeys.has(key) && shouldDisplayField(key, value) && isHumanFieldValue(value))
-        .map(([key, value]) => ({ key, label: labelFor(key), value }))
-        .sort((left, right) => fieldOrder(left.key) - fieldOrder(right.key));
-    if (entries.length === 0) {
-        return [];
-    }
-    const labelWidth = Math.max(...entries.map((entry) => entry.label.length));
-    return entries.map((entry) => `${paint("dim", pad(entry.label, labelWidth))}  ${formatHumanValue(entry.value)}`);
-};
-const hasVisibleComplexValues = (record, excludedKeys) => Object.entries(record).some(([key, value]) => !excludedKeys.has(key) && shouldDisplayField(key, value) && !isHumanFieldValue(value));
-const renderArray = (values, paint) => {
-    if (values.length === 0) {
-        return ["(empty)"];
-    }
-    if (!values.every(isRecord)) {
-        return [indent(JSON.stringify(values, null, 2))];
-    }
-    const rows = values.map((value) => value);
-    const columns = columnsFor(rows);
-    if (columns.length === 0) {
-        return [indent(JSON.stringify(values, null, 2))];
-    }
-    const renderedRows = rows.slice(0, 20).map((row) => columns.map((column) => truncate(formatScalar(row[column]), widthFor(column))));
-    const widths = columns.map((column, index) => Math.max(column.length, ...renderedRows.map((row) => row[index]?.length ?? 0)));
-    const header = columns.map((column, index) => pad(truncate(column, widthFor(column)), widths[index] ?? column.length)).join("  ");
-    const divider = widths.map((width) => "-".repeat(width)).join("  ");
-    const body = renderedRows.map((row) => row.map((cell, index) => pad(cell, widths[index] ?? cell.length)).join("  "));
-    const hiddenCount = values.length - renderedRows.length;
-    return [
-        paint("dim", header),
-        paint("dim", divider),
-        ...body,
-        hiddenCount > 0 ? paint("dim", `... ${hiddenCount} more`) : ""
-    ].filter((line) => line !== "");
-};
-const columnsFor = (rows) => {
-    const preferred = ["id", "channel", "ts", "user", "name", "real_name", "type", "subtype", "text"];
-    const discovered = new Set(rows.flatMap((row) => Object.keys(row).filter((key) => isScalar(row[key]))));
-    const ordered = preferred.filter((key) => discovered.has(key));
-    for (const key of discovered) {
-        if (!ordered.includes(key)) {
-            ordered.push(key);
-        }
-        if (ordered.length >= 5) {
-            break;
-        }
-    }
-    return ordered.slice(0, 5);
-};
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const isScalar = (value) => value === null || ["boolean", "number", "string"].includes(typeof value);
-const isHumanFieldValue = (value) => isScalar(value) || (Array.isArray(value) && value.every(isScalar));
-const shouldDisplayField = (key, value) => {
-    if (key === "ok" && value === true) {
-        return false;
-    }
-    if (value === null || value === undefined) {
-        return false;
-    }
-    if (/^has[A-Z].*Token$/.test(key) && value === false) {
-        return false;
-    }
-    return true;
-};
-const labelOverrides = {
-    botId: "Bot",
-    botToken: "Bot token",
-    channelId: "Channel",
-    enterpriseId: "Enterprise",
-    hasAdminToken: "Admin token",
-    hasAppToken: "App token",
-    hasBotToken: "Bot token",
-    hasUserToken: "User token",
-    messageTs: "Message TS",
-    name: "Name",
-    profile: "Profile",
-    scopes: "Scopes",
-    teamId: "Team",
-    tokenType: "Token",
-    userId: "User"
-};
-const orderedFields = [
-    "name",
-    "teamId",
-    "enterpriseId",
-    "userId",
-    "botId",
-    "tokenType",
-    "hasBotToken",
-    "hasUserToken",
-    "hasAdminToken",
-    "hasAppToken",
-    "scopes"
-];
-const fieldOrder = (key) => {
-    const index = orderedFields.indexOf(key);
-    return index === -1 ? orderedFields.length : index;
-};
-const labelFor = (key) => labelOverrides[key] ?? titleCase(key.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/_/g, " "));
-const titleCase = (value) => value.split(" ").map((word) => word.toLowerCase() === "id" ? "ID" : word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-const formatHumanValue = (value) => {
-    if (Array.isArray(value)) {
-        return value.length === 0 ? "(none)" : value.map(formatScalar).join(", ");
-    }
-    if (typeof value === "boolean") {
-        return value ? "yes" : "no";
-    }
-    return formatScalar(value);
-};
-const formatScalar = (value) => {
-    if (value === undefined) {
-        return "";
-    }
-    if (value === null) {
-        return "-";
-    }
-    if (typeof value === "string") {
-        return value;
-    }
-    return String(value);
-};
-const indent = (value) => value.split("\n").map((line) => `  ${line}`).join("\n");
-const pad = (value, width) => value + " ".repeat(Math.max(0, width - value.length));
-const widthFor = (column) => column === "text" ? 72 : 24;
-const truncate = (value, width) => value.length > width ? `${value.slice(0, Math.max(0, width - 3))}...` : value;

package/dist/output/projection.js

@@ -1,55 +0,0 @@
-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

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

package/dist/ports/MethodCatalog.js

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

package/dist/ports/OAuthFlow.js

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

package/dist/ports/SlackWebApi.js

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

package/dist/ports/TokenStore.js

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