@agent-relay/slack-primitive 6.0.12

package/dist/workflow-step.d.ts

@@ -0,0 +1,80 @@
+import type { RunnerStepExecutor, WorkflowStep } from '@agent-relay/workflow-types';
+import { SlackClient } from './client.js';
+import { type SlackActionResult, type SlackRuntimeConfig } from './types.js';
+export type SlackStepOutputMode = 'data' | 'result' | 'summary' | 'raw' | 'none';
+export type SlackStepOutputFormat = 'json' | 'text';
+export interface SlackStepOutputConfig {
+    /** Which action result becomes the workflow step output. Defaults to "data". */
+    mode?: SlackStepOutputMode;
+    /** Emit JSON for structured chaining or text for simple downstream interpolation. Defaults to "json". */
+    format?: SlackStepOutputFormat;
+    /** Select a nested field from the projected output, e.g. "ts" or "data.channel". */
+    path?: string;
+    /** Include adapter metadata such as runtime and timing in JSON output. Defaults false. */
+    includeMetadata?: boolean;
+    /** Pretty-print JSON output. Defaults false. */
+    pretty?: boolean;
+}
+export interface SlackStepConfig {
+    /** Unique step name within the workflow. */
+    name: string;
+    /** Dependencies in the Relay workflow DAG. */
+    dependsOn?: string[];
+    /** Slack action to execute. Phase A supports postMessage. */
+    action: 'postMessage';
+    /** Slack channel id or #channel-name reference. Falls back to SLACK_DEFAULT_CHANNEL when omitted. */
+    channel?: string;
+    /** Message text. Values may include workflow templates such as {{steps.plan.output.title}}. */
+    text: string;
+    /** Optional parent message timestamp for threaded delivery. */
+    threadTs?: string;
+    /** User mentions to prefix when resolved. Unresolved mentions are soft warnings in output. */
+    mentions?: string[];
+    /** Slack unfurl setting for links and media. */
+    unfurl?: boolean;
+    /** Runtime settings for the local Slack Web API runtime. */
+    config?: SlackRuntimeConfig;
+    /** Controls the string captured as {{steps.<name>.output}}. */
+    output?: SlackStepOutputConfig;
+    /** Workflow step timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Number of retry attempts when the workflow runner retries this integration step. */
+    retries?: number;
+}
+export interface SlackStepExecutionContext {
+    workspaceId?: string;
+    client?: SlackClient;
+    config?: SlackRuntimeConfig;
+}
+export interface SlackStepExecutionResult<TOutput = unknown> {
+    success: boolean;
+    output: string;
+    result: SlackActionResult<TOutput>;
+    error?: string;
+}
+export interface SlackIntegrationStepResult {
+    output: string;
+    success: boolean;
+}
+/**
+ * Create a Relay integration step for posting a Slack message.
+ * @param config - Slack step configuration.
+ * @returns Workflow integration step.
+ */
+export declare function createSlackStep(config: SlackStepConfig): WorkflowStep;
+export declare class SlackStepExecutor implements RunnerStepExecutor {
+    private readonly options;
+    constructor(options?: SlackRuntimeConfig);
+    executeAgentStep(): Promise<string>;
+    execute<TOutput = unknown>(config: SlackStepConfig, context?: SlackStepExecutionContext): Promise<SlackStepExecutionResult<TOutput>>;
+    executeIntegrationStep(step: WorkflowStep, resolvedParams: Record<string, string>): Promise<SlackIntegrationStepResult>;
+}
+/**
+ * Rebuild a Slack step config from resolved workflow params.
+ * @param step - Workflow step.
+ * @param resolvedParams - Params after workflow templating.
+ * @returns Slack step configuration.
+ */
+export declare function slackStepConfigFromWorkflowStep(step: WorkflowStep, resolvedParams: Record<string, string>): SlackStepConfig;
+export declare function renderSlackTemplates(value: string, data: Record<string, unknown>): string;
+//# sourceMappingURL=workflow-step.d.ts.map

package/dist/workflow-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-step.d.ts","sourceRoot":"","sources":["../src/workflow-step.ts"],"names":[],"mappings":"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"}

package/dist/workflow-step.js

@@ -0,0 +1,355 @@
+import { SlackClient } from './client.js';
+import { SlackAction, SLACK_ACTIONS, } from './types.js';
+const SLACK_INTEGRATION = 'slack';
+const RESERVED_PARAM_KEYS = new Set(['action', 'config', 'slackConfig', 'output', 'params']);
+/**
+ * Create a Relay integration step for posting a Slack message.
+ * @param config - Slack step configuration.
+ * @returns Workflow integration step.
+ */
+export function createSlackStep(config) {
+    validateSlackStepConfig(config);
+    const params = {
+        text: config.text,
+    };
+    if (config.channel !== undefined)
+        params.channel = config.channel;
+    if (config.threadTs !== undefined)
+        params.threadTs = config.threadTs;
+    if (config.mentions !== undefined)
+        params.mentions = JSON.stringify(config.mentions);
+    if (config.unfurl !== undefined)
+        params.unfurl = String(config.unfurl);
+    if (config.config !== undefined)
+        params.config = JSON.stringify(config.config);
+    if (config.output !== undefined)
+        params.output = JSON.stringify(config.output);
+    const step = {
+        name: config.name,
+        type: 'integration',
+        integration: SLACK_INTEGRATION,
+        action: config.action,
+        params,
+    };
+    if (config.dependsOn !== undefined)
+        step.dependsOn = config.dependsOn;
+    if (config.timeoutMs !== undefined)
+        step.timeoutMs = config.timeoutMs;
+    if (config.retries !== undefined)
+        step.retries = config.retries;
+    return step;
+}
+export class SlackStepExecutor {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async executeAgentStep() {
+        throw new Error('SlackStepExecutor only executes Slack integration steps.');
+    }
+    async execute(config, context = {}) {
+        validateSlackStepConfig(config);
+        const runtimeConfig = mergeRuntimeConfig(this.options, context.config, config.config);
+        const client = context.client ?? new SlackClient(runtimeConfig);
+        const params = buildActionParams(config);
+        const result = await client.executeAction(SlackAction.PostMessage, params);
+        const output = formatStepOutput(config, result);
+        return {
+            success: result.success,
+            output,
+            result,
+            error: result.error,
+        };
+    }
+    async executeIntegrationStep(step, resolvedParams) {
+        if (step.integration !== SLACK_INTEGRATION) {
+            return {
+                success: false,
+                output: `SlackStepExecutor only handles "${SLACK_INTEGRATION}" integration steps`,
+            };
+        }
+        try {
+            const config = slackStepConfigFromWorkflowStep(step, resolvedParams);
+            const result = await this.execute(config);
+            return {
+                success: result.success,
+                output: result.success ? result.output : result.output || result.error || 'Slack step failed',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+/**
+ * Rebuild a Slack step config from resolved workflow params.
+ * @param step - Workflow step.
+ * @param resolvedParams - Params after workflow templating.
+ * @returns Slack step configuration.
+ */
+export function slackStepConfigFromWorkflowStep(step, resolvedParams) {
+    const params = normalizeResolvedParams(resolvedParams);
+    const action = step.action;
+    if (action !== SlackAction.PostMessage) {
+        throw new Error(`Slack step "${step.name}" requires action "postMessage"`);
+    }
+    const config = readJsonParam(params.config ?? params.slackConfig, 'config') ?? undefined;
+    const output = readJsonParam(params.output, 'output') ?? undefined;
+    const actionParams = readActionParams(params);
+    return {
+        name: step.name,
+        dependsOn: step.dependsOn,
+        action: SlackAction.PostMessage,
+        channel: readOptionalString(actionParams.channel),
+        text: readRequiredString(actionParams.text, 'text'),
+        threadTs: readOptionalString(actionParams.threadTs),
+        mentions: readStringArray(actionParams.mentions),
+        unfurl: readOptionalBoolean(actionParams.unfurl, 'unfurl'),
+        config,
+        output,
+        timeoutMs: step.timeoutMs,
+        retries: step.retries,
+    };
+}
+export function renderSlackTemplates(value, data) {
+    return value.replace(/\{\{\s*steps\.([A-Za-z0-9_-]+)\.output(?:\.([A-Za-z0-9_.-]+))?\s*\}\}/g, (_match, step, path) => {
+        const stepData = data.steps;
+        if (!isRecord(stepData))
+            return '';
+        const entry = stepData[String(step)];
+        if (!isRecord(entry))
+            return '';
+        const output = entry.output;
+        const resolved = typeof path === 'string' && path.length > 0 ? resolvePath(output, path) : output;
+        return projectionToText(resolved);
+    });
+}
+function validateSlackStepConfig(config) {
+    if (!config.name) {
+        throw new Error('Slack step requires a non-empty name');
+    }
+    if (!SLACK_ACTIONS.includes(config.action)) {
+        throw new Error(`Slack step "${config.name}" uses unsupported action "${config.action}"`);
+    }
+    if (config.action !== SlackAction.PostMessage) {
+        throw new Error(`Slack step "${config.name}" requires action "postMessage"`);
+    }
+    if (typeof config.text !== 'string' || config.text.length === 0) {
+        throw new Error(`Slack step "${config.name}" requires message text`);
+    }
+}
+function buildActionParams(config) {
+    return {
+        channel: config.channel,
+        text: config.text,
+        threadTs: config.threadTs,
+        mentions: config.mentions,
+        unfurl: config.unfurl,
+    };
+}
+function readActionParams(params) {
+    const serializedParams = params.params;
+    if (serializedParams !== undefined) {
+        const parsed = readJsonParam(serializedParams, 'params');
+        if (parsed === undefined)
+            return {};
+        if (!isRecord(parsed)) {
+            throw new Error('Slack step params.params must be a JSON object');
+        }
+        return parsed;
+    }
+    const actionParams = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (RESERVED_PARAM_KEYS.has(key))
+            continue;
+        actionParams[key] = value;
+    }
+    return actionParams;
+}
+function mergeRuntimeConfig(...configs) {
+    const merged = {};
+    for (const config of configs) {
+        if (!config)
+            continue;
+        const { env, ...flatConfig } = config;
+        Object.assign(merged, flatConfig);
+        if (env) {
+            merged.env = {
+                ...merged.env,
+                ...env,
+            };
+        }
+    }
+    return merged;
+}
+function formatStepOutput(config, result) {
+    const outputConfig = config.output ?? {};
+    const mode = outputConfig.mode ?? 'data';
+    const format = outputConfig.format ?? 'json';
+    if (mode === 'none') {
+        return '';
+    }
+    let projection = buildOutputProjection(mode, result, outputConfig);
+    if (outputConfig.path) {
+        projection = resolvePath(projection, outputConfig.path);
+    }
+    if (format === 'text') {
+        return projectionToText(projection);
+    }
+    return JSON.stringify(projection, undefined, outputConfig.pretty ? 2 : undefined);
+}
+function buildOutputProjection(mode, result, outputConfig) {
+    if (mode === 'raw')
+        return result.output;
+    if (mode === 'summary') {
+        return withOptionalMetadata(summarizeResult(result), result, outputConfig);
+    }
+    if (mode === 'result') {
+        const projected = {
+            success: result.success,
+            output: result.output,
+        };
+        if (result.data !== undefined)
+            projected.data = result.data;
+        if (result.error !== undefined)
+            projected.error = result.error;
+        return withOptionalMetadata(projected, result, outputConfig);
+    }
+    return withOptionalMetadata(result.data ?? (result.output ? result.output : (result.error ?? null)), result, outputConfig);
+}
+function summarizeResult(result) {
+    if (!result.success) {
+        return {
+            success: false,
+            error: result.error ?? 'Slack action failed',
+        };
+    }
+    if (isRecord(result.data)) {
+        return {
+            success: true,
+            channel: result.data.channel,
+            ts: result.data.ts,
+            unresolvedMentions: result.data.unresolvedMentions,
+        };
+    }
+    return {
+        success: true,
+        value: result.data ?? result.output,
+    };
+}
+function withOptionalMetadata(value, result, outputConfig) {
+    if (!outputConfig.includeMetadata || result.metadata === undefined) {
+        return value;
+    }
+    return {
+        value,
+        metadata: result.metadata,
+    };
+}
+function projectionToText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === null || value === undefined)
+        return '';
+    if (Array.isArray(value))
+        return value.map((entry) => projectionToText(entry)).join('\n');
+    if (isRecord(value)) {
+        if ('output' in value)
+            return projectionToText(value.output);
+        if ('value' in value)
+            return projectionToText(value.value);
+        if ('text' in value)
+            return projectionToText(value.text);
+        if ('ts' in value)
+            return projectionToText(value.ts);
+        if ('channel' in value)
+            return projectionToText(value.channel);
+    }
+    return JSON.stringify(value);
+}
+function resolvePath(value, path) {
+    if (!path)
+        return value;
+    let current = value;
+    for (const segment of path.split('.')) {
+        if (Array.isArray(current) && /^\d+$/.test(segment)) {
+            current = current[Number(segment)];
+            continue;
+        }
+        if (isRecord(current)) {
+            current = current[segment];
+            continue;
+        }
+        return undefined;
+    }
+    return current;
+}
+function normalizeResolvedParams(params) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(params)) {
+        normalized[key] = coerceScalar(value);
+    }
+    return normalized;
+}
+function coerceScalar(value) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) ||
+        (trimmed.startsWith('[') && trimmed.endsWith(']')) ||
+        (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return value;
+        }
+    }
+    return value;
+}
+function readJsonParam(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error(`Slack step params.${name} must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function readRequiredString(value, name) {
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    throw new Error(`Slack step requires ${name}`);
+}
+function readOptionalString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function readStringArray(value) {
+    if (value === undefined)
+        return undefined;
+    if (Array.isArray(value) && value.every((item) => typeof item === 'string'))
+        return value;
+    throw new Error('Slack step mentions must be a string array');
+}
+function readOptionalBoolean(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'boolean')
+        return value;
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    throw new Error(`Slack step ${name} must be a boolean`);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=workflow-step.js.map

package/dist/workflow-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-step.js","sourceRoot":"","sources":["../src/workflow-step.ts"],"names":[],"mappings":"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"}

package/examples/README.md

@@ -0,0 +1,40 @@
+# Slack Primitive Examples
+
+## Runtime selection
+
+`SlackClient` / `SlackStepExecutor` picks one of three runtimes automatically based on what's in the environment:
+
+| Priority | Runtime       | Activated by                        | Transport                                                                                                                                                      |
+| -------- | ------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1        | `cloud-relay` | `CLOUD_API_TOKEN` + `CLOUD_API_URL` | `POST /api/v1/slack/post-message` on relay-cloud, which uses the workspace's Nango Slack connection (the ricky app). The caller never holds a Slack bot token. |
+| 2        | `local`       | `SLACK_BOT_TOKEN`                   | `@slack/web-api` direct to Slack.                                                                                                                              |
+| 3        | `noop`        | _(neither)_                         | Calls succeed, log a warning, and return a placeholder `ts`. Useful for CI / smoke runs where Slack delivery isn't required.                                   |
+
+Override with `runtime: 'local' | 'cloud-relay' | 'noop' | 'auto'` in the config.
+
+> v1 limitation: in `cloud-relay` mode, `resolveUser` and `resolveChannel` throw `unsupported_in_cloud_relay`. Pass Slack user/channel IDs directly. Mention resolution (`@email@example.com`, `@handle`) is local-only.
+
+## Manual Smoke Test (local runtime)
+
+Set `SLACK_BOT_TOKEN` to a bot token with `chat:write`, `channels:read`, `groups:read`, `users:read`, and `users:read.email` scopes. Invite the bot to the destination channel and set `SLACK_CHANNEL` to either a channel id or a `#channel-name` reference.
+
+Run the notification example from `packages/slack-primitive`:
+
+```bash
+SLACK_BOT_TOKEN=xoxb-... SLACK_CHANNEL=#engineering npx tsx examples/notify-on-pr.ts
+```
+
+The workflow should open the configured GitHub pull request step and then post a one-line Slack announcement containing the pull request URL. Use `GITHUB_REPO`, `GITHUB_BASE_BRANCH`, and `GITHUB_BRANCH_OVERRIDE` to point the GitHub step at a prepared sandbox branch.
+
+## Manual Smoke Test (cloud-relay runtime)
+
+Connect Slack on the workspace (one-time, via the cloud dashboard's integrations page). Then point the example at relay-cloud with a CLI api token:
+
+```bash
+CLOUD_API_TOKEN=rk_cli_... \
+CLOUD_API_URL=https://api.agentrelay.com \
+SLACK_CHANNEL=#engineering \
+npx tsx examples/notify-on-pr.ts
+```
+
+No `SLACK_BOT_TOKEN` is required — the message is posted via the workspace's existing Nango Slack connection.

package/examples/notify-on-pr.ts

@@ -0,0 +1,93 @@
+import { WorkflowRunner, type RelayYamlConfig } from '@agent-relay/sdk/workflows';
+import { GitHubStepExecutor, createGitHubStep } from '@agent-relay/github-primitive/workflow-step';
+import type { AgentDefinition, RunnerStepExecutor, WorkflowStep } from '@agent-relay/workflow-types';
+
+import { SlackStepExecutor, createSlackStep } from '../src/workflow-step.js';
+
+const repo = process.env.GITHUB_REPO ?? 'AgentWorkforce/scratch';
+const baseBranch = process.env.GITHUB_BASE_BRANCH ?? 'main';
+const branchName = process.env.GITHUB_BRANCH_OVERRIDE ?? `examples/slack-primitive-${Date.now()}`;
+const slackChannel = process.env.SLACK_CHANNEL ?? '#engineering';
+
+const slackExecutor = new SlackStepExecutor({
+  token: process.env.SLACK_BOT_TOKEN,
+});
+const githubExecutor = new GitHubStepExecutor();
+
+const localExecutor: RunnerStepExecutor = {
+  executeAgentStep(
+    _step: WorkflowStep,
+    _agentDef: AgentDefinition,
+    _resolvedTask: string,
+    _timeoutMs?: number
+  ): Promise<string> {
+    return Promise.reject(new Error('notify-on-pr only uses integration steps.'));
+  },
+  async executeIntegrationStep(
+    step: WorkflowStep,
+    resolvedParams: Record<string, string>,
+    context: { workspaceId?: string }
+  ): Promise<{ output: string; success: boolean }> {
+    if (step.integration === 'github') {
+      return githubExecutor.executeIntegrationStep(step, resolvedParams, context);
+    }
+    if (step.integration === 'slack') {
+      return slackExecutor.executeIntegrationStep(step, resolvedParams);
+    }
+    return {
+      success: false,
+      output: `Unsupported integration "${step.integration ?? 'unknown'}"`,
+    };
+  },
+};
+
+const config: RelayYamlConfig = {
+  version: '1.0',
+  name: 'notify-on-pr',
+  description: 'Open a GitHub pull request and announce it in Slack.',
+  swarm: { pattern: 'pipeline' },
+  agents: [],
+  workflows: [
+    {
+      name: 'notify-on-pr',
+      steps: [
+        createGitHubStep({
+          name: 'create-pr',
+          action: 'createPR',
+          repo,
+          params: {
+            title: `examples: slack primitive notification (${branchName})`,
+            body: 'Opened by packages/slack-primitive/examples/notify-on-pr.ts.',
+            base: baseBranch,
+            head: branchName,
+            draft: true,
+          },
+          output: {
+            mode: 'data',
+            format: 'json',
+          },
+        }),
+        createSlackStep({
+          name: 'announce-pr',
+          dependsOn: ['create-pr'],
+          action: 'postMessage',
+          channel: slackChannel,
+          text: 'PR opened: {{steps.create-pr.output.htmlUrl}}',
+          unfurl: true,
+          output: {
+            mode: 'summary',
+            format: 'json',
+            pretty: true,
+          },
+        }),
+      ],
+    },
+  ],
+};
+
+const runner = new WorkflowRunner({
+  cwd: process.cwd(),
+  executor: localExecutor,
+});
+
+await runner.execute(config);

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@agent-relay/slack-primitive",
+  "version": "6.0.12",
+  "description": "Slack workflow primitive for Agent Relay",
+  "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"
+    },
+    "./workflow-step": {
+      "types": "./dist/workflow-step.d.ts",
+      "import": "./dist/workflow-step.js",
+      "default": "./dist/workflow-step.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck:examples": "tsc -p tsconfig.examples.json --noEmit"
+  },
+  "dependencies": {
+    "@agent-relay/workflow-types": "6.0.12",
+    "@slack/web-api": "^7.15.2"
+  },
+  "devDependencies": {
+    "@agent-relay/github-primitive": "6.0.12",
+    "@types/node": "^22.19.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/slack-primitive"
+  }
+}