@objectstack/connector-slack 17.0.0 → 17.2.0

package/CHANGELOG.md

@@ -1,5 +1,174 @@
 # @objectstack/connector-slack
 
+## 17.2.0
+
+### Patch Changes
+
+- 6d5c4fa: Release these plugins' resources from `destroy()`, the teardown hook the kernel
+  actually calls (#10371). `Plugin` declares `init()`, `start?(ctx)` and
+  `destroy?()` — and no `stop()` — so `ObjectKernel.performShutdown()` and
+  `LiteKernel.destroy()`, which walk the plugins in reverse calling
+  `plugin.destroy()`, walked straight past every plugin whose teardown was spelled
+  `stop()`. `await kernel.shutdown()` resolved with the reports dispatcher still
+  armed, the REST/OpenAPI/Slack connectors still registered on the automation
+  engine, the approvals SLA escalation job still scheduled, and the knowledge
+  event-sync subscription still open.
+  
+  Each teardown body now lives in `destroy()`. `stop()` is retained as a
+  delegating alias with its parameter made optional, so an embedder that learned
+  to call it directly — precisely because the kernel never did — keeps working
+  unchanged. No export is removed and the `Plugin` interface is untouched.
+  
+  Same defect as #9371 in `@objectstack/service-messaging`, which surfaced as
+  fully green test runs exiting 1 on `EnvironmentTeardownError` and being evicted
+  from the merge queue.
+- Updated dependencies [6936d07]
+- Updated dependencies [59eb04d]
+- Updated dependencies [9f05b7d]
+- Updated dependencies [3b2af5e]
+- Updated dependencies [7d2d112]
+- Updated dependencies [5fa0d72]
+- Updated dependencies [02b3b07]
+- Updated dependencies [914c413]
+- Updated dependencies [55809a0]
+- Updated dependencies [ee2ff45]
+- Updated dependencies [47cd3ec]
+- Updated dependencies [52db1d1]
+- Updated dependencies [5649efb]
+- Updated dependencies [9d7d2de]
+- Updated dependencies [c815c50]
+- Updated dependencies [795ea05]
+- Updated dependencies [2306a76]
+- Updated dependencies [e5ea701]
+- Updated dependencies [a40dcc1]
+- Updated dependencies [def0d3e]
+- Updated dependencies [8d0bb79]
+- Updated dependencies [5acb58d]
+- Updated dependencies [2e3cf95]
+- Updated dependencies [4c93387]
+- Updated dependencies [504c8d5]
+- Updated dependencies [a037f7c]
+- Updated dependencies [3ee8ddf]
+- Updated dependencies [16cef97]
+- Updated dependencies [a79bd35]
+- Updated dependencies [6ceaa4b]
+- Updated dependencies [15ea214]
+- Updated dependencies [de19489]
+- Updated dependencies [c684d00]
+- Updated dependencies [923c424]
+- Updated dependencies [1ec36b7]
+- Updated dependencies [5f2e54c]
+- Updated dependencies [189373b]
+- Updated dependencies [35ad101]
+- Updated dependencies [ceb33a9]
+- Updated dependencies [73d9795]
+- Updated dependencies [8012960]
+- Updated dependencies [f34f56b]
+- Updated dependencies [f399618]
+- Updated dependencies [75e9301]
+- Updated dependencies [2810695]
+  - @objectstack/spec@17.2.0
+  - @objectstack/core@17.2.0
+
+## 17.1.0
+
+### Patch Changes
+
+- Updated dependencies [56656aa]
+- Updated dependencies [07e630e]
+- Updated dependencies [2f65b1b]
+- Updated dependencies [720ee95]
+- Updated dependencies [f287435]
+- Updated dependencies [2782805]
+- Updated dependencies [e43d63a]
+- Updated dependencies [9aa8890]
+- Updated dependencies [7c9c1dd]
+- Updated dependencies [75b7c24]
+- Updated dependencies [d5552ca]
+- Updated dependencies [d9813a9]
+- Updated dependencies [8640fb2]
+- Updated dependencies [2420641]
+- Updated dependencies [2ad91c3]
+- Updated dependencies [f57fb38]
+- Updated dependencies [00777a0]
+- Updated dependencies [d491625]
+- Updated dependencies [420804d]
+- Updated dependencies [716ac9b]
+- Updated dependencies [a38408a]
+- Updated dependencies [62b1427]
+- Updated dependencies [7ea1372]
+- Updated dependencies [23abe27]
+- Updated dependencies [985a9cd]
+- Updated dependencies [5f5e234]
+- Updated dependencies [a8189ae]
+- Updated dependencies [26e70fb]
+- Updated dependencies [42b05af]
+- Updated dependencies [2b292ce]
+- Updated dependencies [abcf853]
+- Updated dependencies [8b9eba5]
+- Updated dependencies [d575779]
+- Updated dependencies [94f7ef8]
+- Updated dependencies [c5ac5e4]
+- Updated dependencies [a777944]
+- Updated dependencies [dd88e1c]
+- Updated dependencies [856527c]
+- Updated dependencies [870f710]
+- Updated dependencies [79c46da]
+- Updated dependencies [7ff3975]
+- Updated dependencies [29d055b]
+- Updated dependencies [65589d6]
+- Updated dependencies [2c86fe3]
+- Updated dependencies [e196c6a]
+- Updated dependencies [24173e9]
+- Updated dependencies [4ab7523]
+- Updated dependencies [19539b4]
+- Updated dependencies [f8eb736]
+- Updated dependencies [11b779e]
+- Updated dependencies [739fe5b]
+- Updated dependencies [4bfe1a5]
+- Updated dependencies [2065e31]
+- Updated dependencies [b69d0f5]
+- Updated dependencies [4d47afe]
+- Updated dependencies [e4e5c6e]
+- Updated dependencies [9a56784]
+- Updated dependencies [d00d2f6]
+- Updated dependencies [df0c12d]
+- Updated dependencies [d31785f]
+- Updated dependencies [c308a4f]
+- Updated dependencies [e2899f6]
+- Updated dependencies [3851f87]
+- Updated dependencies [2a29caa]
+- Updated dependencies [09a6eee]
+- Updated dependencies [1a7f907]
+- Updated dependencies [cd455c8]
+- Updated dependencies [e1bb0ca]
+- Updated dependencies [30d3752]
+- Updated dependencies [c80e7ae]
+- Updated dependencies [09a9a8a]
+- Updated dependencies [07026cf]
+- Updated dependencies [5d4f3d5]
+- Updated dependencies [4d80e8b]
+- Updated dependencies [30b1c63]
+- Updated dependencies [079b457]
+- Updated dependencies [e43b211]
+- Updated dependencies [890b38f]
+- Updated dependencies [8bee54b]
+- Updated dependencies [7a537ce]
+- Updated dependencies [593c4bf]
+- Updated dependencies [ff08691]
+- Updated dependencies [60e0f90]
+- Updated dependencies [90c5285]
+- Updated dependencies [402c125]
+- Updated dependencies [7901b2d]
+- Updated dependencies [56bca91]
+- Updated dependencies [79394d7]
+- Updated dependencies [730fd9a]
+- Updated dependencies [44bc51d]
+- Updated dependencies [73cfddf]
+- Updated dependencies [d634e66]
+  - @objectstack/spec@17.1.0
+  - @objectstack/core@17.1.0
+
 ## 17.0.0
 
 ### Patch Changes

package/dist/index.d.mts

@@ -99,7 +99,30 @@ declare class ConnectorSlackPlugin implements Plugin {
     constructor(options: ConnectorSlackPluginOptions);
     init(_ctx: PluginContext): Promise<void>;
     start(ctx: PluginContext): Promise<void>;
-    stop(_ctx: PluginContext): Promise<void>;
+    /**
+     * The kernel's teardown hook (`Plugin.destroy?()`, core `types.ts`) — the
+     * ONLY teardown entry point `ObjectKernel.performShutdown()` and
+     * `LiteKernel.destroy()` invoke.
+     *
+     * [#10371] IT USED TO BE `stop()`, WHICH NOTHING CALLED. `Plugin` declares
+     * `init()`, `start?()` and `destroy?()` and no `stop()`, so the kernel
+     * walked past this plugin at shutdown and the Slack connector stayed registered in the automation
+     * engine for the lifetime of the process. `start()` IS on the
+     * interface, so the pair read as symmetric in review — that asymmetry is
+     * what let the same shape survive in six packages at once.
+     *
+     * No timers here, so this instance never cost a merge-queue eviction the
+     * way the `plugin-reports` / `service-messaging` members did (#9371). The
+     * class is the same one either way: a teardown the kernel does not reach.
+     */
+    destroy(): Promise<void>;
+    /**
+     * Retained alias for {@link destroy}. Kept because it is public API of an
+     * exported class, and removing it would break an embedder who learned to
+     * call it directly precisely BECAUSE the kernel never did. Prefer kernel
+     * shutdown; direct callers keep working unchanged.
+     */
+    stop(_ctx?: PluginContext): Promise<void>;
 }
 
 export { type ConnectorRegistrySurface, ConnectorSlackPlugin, type ConnectorSlackPluginOptions, type SlackConnectorBundle, type SlackConnectorOptions, type SlackPostMessageInput, type SlackResult, createSlackConnector };

package/dist/index.d.ts

@@ -99,7 +99,30 @@ declare class ConnectorSlackPlugin implements Plugin {
     constructor(options: ConnectorSlackPluginOptions);
     init(_ctx: PluginContext): Promise<void>;
     start(ctx: PluginContext): Promise<void>;
-    stop(_ctx: PluginContext): Promise<void>;
+    /**
+     * The kernel's teardown hook (`Plugin.destroy?()`, core `types.ts`) — the
+     * ONLY teardown entry point `ObjectKernel.performShutdown()` and
+     * `LiteKernel.destroy()` invoke.
+     *
+     * [#10371] IT USED TO BE `stop()`, WHICH NOTHING CALLED. `Plugin` declares
+     * `init()`, `start?()` and `destroy?()` and no `stop()`, so the kernel
+     * walked past this plugin at shutdown and the Slack connector stayed registered in the automation
+     * engine for the lifetime of the process. `start()` IS on the
+     * interface, so the pair read as symmetric in review — that asymmetry is
+     * what let the same shape survive in six packages at once.
+     *
+     * No timers here, so this instance never cost a merge-queue eviction the
+     * way the `plugin-reports` / `service-messaging` members did (#9371). The
+     * class is the same one either way: a teardown the kernel does not reach.
+     */
+    destroy(): Promise<void>;
+    /**
+     * Retained alias for {@link destroy}. Kept because it is public API of an
+     * exported class, and removing it would break an embedder who learned to
+     * call it directly precisely BECAUSE the kernel never did. Prefer kernel
+     * shutdown; direct callers keep working unchanged.
+     */
+    stop(_ctx?: PluginContext): Promise<void>;
 }
 
 export { type ConnectorRegistrySurface, ConnectorSlackPlugin, type ConnectorSlackPluginOptions, type SlackConnectorBundle, type SlackConnectorOptions, type SlackPostMessageInput, type SlackResult, createSlackConnector };

package/dist/index.js

@@ -177,13 +177,40 @@ var ConnectorSlackPlugin = class {
     this.connectorName = def.name;
     ctx.logger.info(`ConnectorSlackPlugin: Slack connector '${def.name}' registered`);
   }
-  async stop(_ctx) {
+  /**
+   * The kernel's teardown hook (`Plugin.destroy?()`, core `types.ts`) — the
+   * ONLY teardown entry point `ObjectKernel.performShutdown()` and
+   * `LiteKernel.destroy()` invoke.
+   *
+   * [#10371] IT USED TO BE `stop()`, WHICH NOTHING CALLED. `Plugin` declares
+   * `init()`, `start?()` and `destroy?()` and no `stop()`, so the kernel
+   * walked past this plugin at shutdown and the Slack connector stayed registered in the automation
+   * engine for the lifetime of the process. `start()` IS on the
+   * interface, so the pair read as symmetric in review — that asymmetry is
+   * what let the same shape survive in six packages at once.
+   *
+   * No timers here, so this instance never cost a merge-queue eviction the
+   * way the `plugin-reports` / `service-messaging` members did (#9371). The
+   * class is the same one either way: a teardown the kernel does not reach.
+   */
+  async destroy() {
     if (this.automation && this.connectorName) {
       try {
         this.automation.unregisterConnector(this.connectorName);
       } catch {
       }
     }
+    this.automation = void 0;
+    this.connectorName = void 0;
+  }
+  /**
+   * Retained alias for {@link destroy}. Kept because it is public API of an
+   * exported class, and removing it would break an embedder who learned to
+   * call it directly precisely BECAUSE the kernel never did. Prefer kernel
+   * shutdown; direct callers keep working unchanged.
+   */
+  async stop(_ctx) {
+    await this.destroy();
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/slack-connector.ts","../src/connector-slack-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * @objectstack/connector-slack\n *\n * Slack Web API connector — a concrete connector (ADR-0018 §Addendum) and the\n * second reference implementation after `@objectstack/connector-rest`. The\n * baseline automation engine ships the `connector_action` dispatch node + an\n * empty connector registry; this plugin populates it with a `slack` connector\n * exposing `chat.postMessage`, `chat.update`, and a generic `call` action.\n *\n * This is the integration mechanism (ADR-0022 \"raw API call\" path), not the\n * human-notification layer. Static bot-token auth only; OAuth2 install/refresh,\n * credential vaulting, and multi-tenant lifecycle are the enterprise tier.\n */\n\nexport {\n    createSlackConnector,\n    type SlackConnectorOptions,\n    type SlackConnectorBundle,\n    type SlackPostMessageInput,\n    type SlackResult,\n} from './slack-connector.js';\nexport {\n    ConnectorSlackPlugin,\n    type ConnectorSlackPluginOptions,\n    type ConnectorRegistrySurface,\n} from './connector-slack-plugin.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Connector } from '@objectstack/spec/integration';\nimport { resilientFetch } from '@objectstack/spec/shared';\n\n/**\n * Slack connector — a *concrete* connector (ADR-0018 §Addendum) and the second\n * reference implementation after `@objectstack/connector-rest`. It produces a\n * {@link Connector} definition plus handlers for a small set of Slack Web API\n * actions, which the baseline `connector_action` node dispatches to.\n *\n * Scope (ADR-0022 \"raw API call\" path): this is the *integration mechanism*\n * for talking to Slack's API — \"post this exact text to this channel\". It is\n * deliberately **not** the human-notification layer: there is no preference\n * matrix, inbox, outbox, or thread/session semantics here. Those belong to a\n * `MessagingChannel` (ADR-0012/0013), which may itself delegate its transport\n * to this connector.\n *\n * Open-source scope: **static** auth only — a Slack **bot token** (`xoxb-…`),\n * supplied by the caller and sent as a bearer credential. OAuth2 install/refresh,\n * credential vaulting, and multi-tenant connection lifecycle are the enterprise\n * tier (see `../cloud/docs/design/connector-tiering.md`) and are out of scope.\n *\n * Slack quirk: the Web API returns HTTP `200` even on logical failure, with the\n * real outcome in the JSON body's `ok` field (and `error` on failure). Handlers\n * therefore surface `ok` from the payload, not from the HTTP status, and never\n * throw on a logical failure — the flow author branches on `${node.ok}`.\n */\n\nexport interface SlackConnectorOptions {\n    /** Connector machine name (snake_case). Defaults to `slack`. */\n    name?: string;\n    /** Human-readable label. Defaults to `Slack`. */\n    label?: string;\n    /** Slack bot token (`xoxb-…`), sent as `Authorization: Bearer <token>`. */\n    token: string;\n    /** Web API base URL. Defaults to `https://slack.com/api`. */\n    baseUrl?: string;\n    /** Headers merged into every request (request-level headers win). */\n    defaultHeaders?: Record<string, string>;\n    /** Injected for tests; defaults to the global `fetch`. */\n    fetchImpl?: typeof fetch;\n}\n\n/** Input accepted by `chat.postMessage`. */\nexport interface SlackPostMessageInput {\n    /** Channel id (`C…`), user id (`U…`), or channel name (`#general`). */\n    channel: string;\n    /** Message text (fallback when `blocks` are present). */\n    text?: string;\n    /** Thread root `ts` to reply into an existing thread. */\n    thread_ts?: string;\n    /** Block Kit blocks. */\n    blocks?: unknown[];\n    [key: string]: unknown;\n}\n\n/** Generic Slack Web API result envelope. */\nexport interface SlackResult {\n    /** Slack's logical success flag (from the JSON body, not the HTTP status). */\n    ok: boolean;\n    /** HTTP status (almost always 200 for the Slack Web API). */\n    status: number;\n    /** Full parsed Slack payload. */\n    body: Record<string, unknown>;\n    /** Slack error code when `ok` is false (e.g. `channel_not_found`). */\n    error?: string;\n}\n\n/** A connector definition paired with its action handlers, ready for registerConnector(). */\nexport interface SlackConnectorBundle {\n    def: Connector;\n    handlers: Record<\n        string,\n        (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n    >;\n}\n\nexport function createSlackConnector(opts: SlackConnectorOptions): SlackConnectorBundle {\n    const name = opts.name ?? 'slack';\n    const baseUrl = (opts.baseUrl ?? 'https://slack.com/api').replace(/\\/+$/, '');\n\n    const def: Connector = {\n        name,\n        label: opts.label ?? 'Slack',\n        type: 'api',\n        description: 'Slack Web API connector (static bot-token auth). Post and update messages, or call any Web API method.',\n        icon: 'slack',\n        authentication: { type: 'bearer', token: opts.token },\n        // Defaulted by ConnectorSchema; set explicitly so the literal satisfies\n        // the (post-parse) Connector output type.\n        status: 'active',\n        enabled: true,\n        connectionTimeoutMs: 30000,\n        requestTimeoutMs: 30000,\n        actions: [\n            {\n                key: 'chat.postMessage',\n                label: 'Post Message',\n                description: 'Post a message to a channel, DM, or thread (Slack chat.postMessage).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id, user id, or #name' },\n                        text: { type: 'string', description: 'Message text' },\n                        thread_ts: { type: 'string', description: 'Thread root ts to reply into' },\n                        blocks: { type: 'array', description: 'Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'chat.update',\n                label: 'Update Message',\n                description: 'Edit an existing message (Slack chat.update).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel', 'ts'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id' },\n                        ts: { type: 'string', description: 'Timestamp of the message to update' },\n                        text: { type: 'string', description: 'New message text' },\n                        blocks: { type: 'array', description: 'New Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'call',\n                label: 'Call Web API Method',\n                description: 'Escape hatch — call any Slack Web API method with arbitrary params.',\n                inputSchema: {\n                    type: 'object',\n                    required: ['method'],\n                    properties: {\n                        method: { type: 'string', description: 'Web API method, e.g. conversations.list' },\n                        params: { type: 'object', description: 'Method parameters (JSON body)' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n        ],\n    };\n\n    /** POST a JSON body to a Slack Web API method and normalise the result. */\n    async function callSlack(method: string, params: Record<string, unknown>): Promise<SlackResult> {\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json; charset=utf-8',\n            ...opts.defaultHeaders,\n            Authorization: `Bearer ${opts.token}`,\n        };\n\n        const response = await resilientFetch(`${baseUrl}/${method}`, {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n        }, { fetchImpl: opts.fetchImpl });\n\n        // The Slack Web API always answers with JSON; `ok` is the real outcome.\n        const body = (await response.json()) as Record<string, unknown>;\n        const ok = body.ok === true;\n        return {\n            ok,\n            status: response.status,\n            body,\n            error: ok ? undefined : (body.error as string | undefined),\n        };\n    }\n\n    async function postMessage(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.postMessage', input));\n    }\n\n    async function update(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.update', input));\n    }\n\n    async function call(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        const method = String(input.method ?? '');\n        if (!method) throw new Error(\"slack 'call' action: 'method' is required\");\n        const params = (input.params as Record<string, unknown>) ?? {};\n        return toRecord(await callSlack(method, params));\n    }\n\n    return {\n        def,\n        handlers: {\n            'chat.postMessage': postMessage,\n            'chat.update': update,\n            call,\n        },\n    };\n}\n\nfunction toRecord(r: SlackResult): Record<string, unknown> {\n    return { ok: r.ok, status: r.status, body: r.body, error: r.error };\n}\n\nfunction slackOutputSchema(): Record<string, unknown> {\n    return {\n        type: 'object',\n        properties: {\n            ok: { type: 'boolean', description: \"Slack's logical success flag\" },\n            status: { type: 'number', description: 'HTTP status' },\n            body: { type: 'object', description: 'Full Slack response payload' },\n            error: { type: 'string', description: 'Slack error code when ok is false' },\n        },\n    };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { Connector } from '@objectstack/spec/integration';\nimport { createSlackConnector, type SlackConnectorOptions } from './slack-connector.js';\n\n/**\n * Minimal surface of the automation engine this plugin depends on — the\n * connector registry from ADR-0018 §Addendum. Kept structural so the plugin\n * needs no runtime dependency on `@objectstack/service-automation`.\n */\nexport interface ConnectorRegistrySurface {\n    registerConnector(\n        def: Connector,\n        handlers: Record<\n            string,\n            (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n        >,\n    ): void;\n    unregisterConnector(name: string): void;\n}\n\nexport interface ConnectorSlackPluginOptions extends SlackConnectorOptions {}\n\n/**\n * ConnectorSlackPlugin — registers a Slack Web API connector on the automation\n * engine. The second reference concrete connector (ADR-0018 §Addendum); it\n * enables the ADR-0022 \"raw API call\" path — a flow's `connector_action` step\n * can dispatch to `slack.chat.postMessage` without the messaging stack.\n *\n * If no automation engine is present the plugin logs and skips — the connector\n * has nowhere to register, which is not an error.\n */\nexport class ConnectorSlackPlugin implements Plugin {\n    name = 'com.objectstack.connector.slack';\n    version = '1.0.0';\n    type = 'standard' as const;\n    // Ensure the automation engine (and its connector registry) is started first.\n    dependencies = ['com.objectstack.service-automation'];\n\n    private readonly options: ConnectorSlackPluginOptions;\n    private connectorName?: string;\n    private automation?: ConnectorRegistrySurface;\n\n    constructor(options: ConnectorSlackPluginOptions) {\n        this.options = options;\n    }\n\n    async init(_ctx: PluginContext): Promise<void> {\n        // No services to register; the connector is registered in start() once\n        // the automation engine is available.\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        let automation: ConnectorRegistrySurface | undefined;\n        try {\n            automation = ctx.getService<ConnectorRegistrySurface>('automation');\n        } catch {\n            automation = undefined;\n        }\n\n        if (!automation || typeof automation.registerConnector !== 'function') {\n            ctx.logger.info('ConnectorSlackPlugin: no automation engine — Slack connector not registered');\n            return;\n        }\n\n        const { def, handlers } = createSlackConnector(this.options);\n        automation.registerConnector(def, handlers);\n        this.automation = automation;\n        this.connectorName = def.name;\n        ctx.logger.info(`ConnectorSlackPlugin: Slack connector '${def.name}' registered`);\n    }\n\n    async stop(_ctx: PluginContext): Promise<void> {\n        if (this.automation && this.connectorName) {\n            try { this.automation.unregisterConnector(this.connectorName); } catch { /* ignore */ }\n        }\n    }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/slack-connector.ts","../src/connector-slack-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * @objectstack/connector-slack\n *\n * Slack Web API connector — a concrete connector (ADR-0018 §Addendum) and the\n * second reference implementation after `@objectstack/connector-rest`. The\n * baseline automation engine ships the `connector_action` dispatch node + an\n * empty connector registry; this plugin populates it with a `slack` connector\n * exposing `chat.postMessage`, `chat.update`, and a generic `call` action.\n *\n * This is the integration mechanism (ADR-0022 \"raw API call\" path), not the\n * human-notification layer. Static bot-token auth only; OAuth2 install/refresh,\n * credential vaulting, and multi-tenant lifecycle are the enterprise tier.\n */\n\nexport {\n    createSlackConnector,\n    type SlackConnectorOptions,\n    type SlackConnectorBundle,\n    type SlackPostMessageInput,\n    type SlackResult,\n} from './slack-connector.js';\nexport {\n    ConnectorSlackPlugin,\n    type ConnectorSlackPluginOptions,\n    type ConnectorRegistrySurface,\n} from './connector-slack-plugin.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Connector } from '@objectstack/spec/integration';\nimport { resilientFetch } from '@objectstack/spec/shared';\n\n/**\n * Slack connector — a *concrete* connector (ADR-0018 §Addendum) and the second\n * reference implementation after `@objectstack/connector-rest`. It produces a\n * {@link Connector} definition plus handlers for a small set of Slack Web API\n * actions, which the baseline `connector_action` node dispatches to.\n *\n * Scope (ADR-0022 \"raw API call\" path): this is the *integration mechanism*\n * for talking to Slack's API — \"post this exact text to this channel\". It is\n * deliberately **not** the human-notification layer: there is no preference\n * matrix, inbox, outbox, or thread/session semantics here. Those belong to a\n * `MessagingChannel` (ADR-0012/0013), which may itself delegate its transport\n * to this connector.\n *\n * Open-source scope: **static** auth only — a Slack **bot token** (`xoxb-…`),\n * supplied by the caller and sent as a bearer credential. OAuth2 install/refresh,\n * credential vaulting, and multi-tenant connection lifecycle are the enterprise\n * tier (see `../cloud/docs/design/connector-tiering.md`) and are out of scope.\n *\n * Slack quirk: the Web API returns HTTP `200` even on logical failure, with the\n * real outcome in the JSON body's `ok` field (and `error` on failure). Handlers\n * therefore surface `ok` from the payload, not from the HTTP status, and never\n * throw on a logical failure — the flow author branches on `${node.ok}`.\n */\n\nexport interface SlackConnectorOptions {\n    /** Connector machine name (snake_case). Defaults to `slack`. */\n    name?: string;\n    /** Human-readable label. Defaults to `Slack`. */\n    label?: string;\n    /** Slack bot token (`xoxb-…`), sent as `Authorization: Bearer <token>`. */\n    token: string;\n    /** Web API base URL. Defaults to `https://slack.com/api`. */\n    baseUrl?: string;\n    /** Headers merged into every request (request-level headers win). */\n    defaultHeaders?: Record<string, string>;\n    /** Injected for tests; defaults to the global `fetch`. */\n    fetchImpl?: typeof fetch;\n}\n\n/** Input accepted by `chat.postMessage`. */\nexport interface SlackPostMessageInput {\n    /** Channel id (`C…`), user id (`U…`), or channel name (`#general`). */\n    channel: string;\n    /** Message text (fallback when `blocks` are present). */\n    text?: string;\n    /** Thread root `ts` to reply into an existing thread. */\n    thread_ts?: string;\n    /** Block Kit blocks. */\n    blocks?: unknown[];\n    [key: string]: unknown;\n}\n\n/** Generic Slack Web API result envelope. */\nexport interface SlackResult {\n    /** Slack's logical success flag (from the JSON body, not the HTTP status). */\n    ok: boolean;\n    /** HTTP status (almost always 200 for the Slack Web API). */\n    status: number;\n    /** Full parsed Slack payload. */\n    body: Record<string, unknown>;\n    /** Slack error code when `ok` is false (e.g. `channel_not_found`). */\n    error?: string;\n}\n\n/** A connector definition paired with its action handlers, ready for registerConnector(). */\nexport interface SlackConnectorBundle {\n    def: Connector;\n    handlers: Record<\n        string,\n        (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n    >;\n}\n\nexport function createSlackConnector(opts: SlackConnectorOptions): SlackConnectorBundle {\n    const name = opts.name ?? 'slack';\n    const baseUrl = (opts.baseUrl ?? 'https://slack.com/api').replace(/\\/+$/, '');\n\n    const def: Connector = {\n        name,\n        label: opts.label ?? 'Slack',\n        type: 'api',\n        description: 'Slack Web API connector (static bot-token auth). Post and update messages, or call any Web API method.',\n        icon: 'slack',\n        authentication: { type: 'bearer', token: opts.token },\n        // Defaulted by ConnectorSchema; set explicitly so the literal satisfies\n        // the (post-parse) Connector output type.\n        status: 'active',\n        enabled: true,\n        connectionTimeoutMs: 30000,\n        requestTimeoutMs: 30000,\n        actions: [\n            {\n                key: 'chat.postMessage',\n                label: 'Post Message',\n                description: 'Post a message to a channel, DM, or thread (Slack chat.postMessage).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id, user id, or #name' },\n                        text: { type: 'string', description: 'Message text' },\n                        thread_ts: { type: 'string', description: 'Thread root ts to reply into' },\n                        blocks: { type: 'array', description: 'Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'chat.update',\n                label: 'Update Message',\n                description: 'Edit an existing message (Slack chat.update).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel', 'ts'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id' },\n                        ts: { type: 'string', description: 'Timestamp of the message to update' },\n                        text: { type: 'string', description: 'New message text' },\n                        blocks: { type: 'array', description: 'New Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'call',\n                label: 'Call Web API Method',\n                description: 'Escape hatch — call any Slack Web API method with arbitrary params.',\n                inputSchema: {\n                    type: 'object',\n                    required: ['method'],\n                    properties: {\n                        method: { type: 'string', description: 'Web API method, e.g. conversations.list' },\n                        params: { type: 'object', description: 'Method parameters (JSON body)' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n        ],\n    };\n\n    /** POST a JSON body to a Slack Web API method and normalise the result. */\n    async function callSlack(method: string, params: Record<string, unknown>): Promise<SlackResult> {\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json; charset=utf-8',\n            ...opts.defaultHeaders,\n            Authorization: `Bearer ${opts.token}`,\n        };\n\n        const response = await resilientFetch(`${baseUrl}/${method}`, {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n        }, { fetchImpl: opts.fetchImpl });\n\n        // The Slack Web API always answers with JSON; `ok` is the real outcome.\n        const body = (await response.json()) as Record<string, unknown>;\n        const ok = body.ok === true;\n        return {\n            ok,\n            status: response.status,\n            body,\n            error: ok ? undefined : (body.error as string | undefined),\n        };\n    }\n\n    async function postMessage(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.postMessage', input));\n    }\n\n    async function update(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.update', input));\n    }\n\n    async function call(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        const method = String(input.method ?? '');\n        if (!method) throw new Error(\"slack 'call' action: 'method' is required\");\n        const params = (input.params as Record<string, unknown>) ?? {};\n        return toRecord(await callSlack(method, params));\n    }\n\n    return {\n        def,\n        handlers: {\n            'chat.postMessage': postMessage,\n            'chat.update': update,\n            call,\n        },\n    };\n}\n\nfunction toRecord(r: SlackResult): Record<string, unknown> {\n    return { ok: r.ok, status: r.status, body: r.body, error: r.error };\n}\n\nfunction slackOutputSchema(): Record<string, unknown> {\n    return {\n        type: 'object',\n        properties: {\n            ok: { type: 'boolean', description: \"Slack's logical success flag\" },\n            status: { type: 'number', description: 'HTTP status' },\n            body: { type: 'object', description: 'Full Slack response payload' },\n            error: { type: 'string', description: 'Slack error code when ok is false' },\n        },\n    };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { Connector } from '@objectstack/spec/integration';\nimport { createSlackConnector, type SlackConnectorOptions } from './slack-connector.js';\n\n/**\n * Minimal surface of the automation engine this plugin depends on — the\n * connector registry from ADR-0018 §Addendum. Kept structural so the plugin\n * needs no runtime dependency on `@objectstack/service-automation`.\n */\nexport interface ConnectorRegistrySurface {\n    registerConnector(\n        def: Connector,\n        handlers: Record<\n            string,\n            (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n        >,\n    ): void;\n    unregisterConnector(name: string): void;\n}\n\nexport interface ConnectorSlackPluginOptions extends SlackConnectorOptions {}\n\n/**\n * ConnectorSlackPlugin — registers a Slack Web API connector on the automation\n * engine. The second reference concrete connector (ADR-0018 §Addendum); it\n * enables the ADR-0022 \"raw API call\" path — a flow's `connector_action` step\n * can dispatch to `slack.chat.postMessage` without the messaging stack.\n *\n * If no automation engine is present the plugin logs and skips — the connector\n * has nowhere to register, which is not an error.\n */\nexport class ConnectorSlackPlugin implements Plugin {\n    name = 'com.objectstack.connector.slack';\n    version = '1.0.0';\n    type = 'standard' as const;\n    // Ensure the automation engine (and its connector registry) is started first.\n    dependencies = ['com.objectstack.service-automation'];\n\n    private readonly options: ConnectorSlackPluginOptions;\n    private connectorName?: string;\n    private automation?: ConnectorRegistrySurface;\n\n    constructor(options: ConnectorSlackPluginOptions) {\n        this.options = options;\n    }\n\n    async init(_ctx: PluginContext): Promise<void> {\n        // No services to register; the connector is registered in start() once\n        // the automation engine is available.\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        let automation: ConnectorRegistrySurface | undefined;\n        try {\n            automation = ctx.getService<ConnectorRegistrySurface>('automation');\n        } catch {\n            automation = undefined;\n        }\n\n        if (!automation || typeof automation.registerConnector !== 'function') {\n            ctx.logger.info('ConnectorSlackPlugin: no automation engine — Slack connector not registered');\n            return;\n        }\n\n        const { def, handlers } = createSlackConnector(this.options);\n        automation.registerConnector(def, handlers);\n        this.automation = automation;\n        this.connectorName = def.name;\n        ctx.logger.info(`ConnectorSlackPlugin: Slack connector '${def.name}' registered`);\n    }\n\n    /**\n     * The kernel's teardown hook (`Plugin.destroy?()`, core `types.ts`) — the\n     * ONLY teardown entry point `ObjectKernel.performShutdown()` and\n     * `LiteKernel.destroy()` invoke.\n     *\n     * [#10371] IT USED TO BE `stop()`, WHICH NOTHING CALLED. `Plugin` declares\n     * `init()`, `start?()` and `destroy?()` and no `stop()`, so the kernel\n     * walked past this plugin at shutdown and the Slack connector stayed registered in the automation\n     * engine for the lifetime of the process. `start()` IS on the\n     * interface, so the pair read as symmetric in review — that asymmetry is\n     * what let the same shape survive in six packages at once.\n     *\n     * No timers here, so this instance never cost a merge-queue eviction the\n     * way the `plugin-reports` / `service-messaging` members did (#9371). The\n     * class is the same one either way: a teardown the kernel does not reach.\n     */\n    async destroy(): Promise<void> {\n        if (this.automation && this.connectorName) {\n            try { this.automation.unregisterConnector(this.connectorName); } catch { /* ignore */ }\n        }\n        this.automation = undefined;\n        this.connectorName = undefined;\n    }\n\n    /**\n     * Retained alias for {@link destroy}. Kept because it is public API of an\n     * exported class, and removing it would break an embedder who learned to\n     * call it directly precisely BECAUSE the kernel never did. Prefer kernel\n     * shutdown; direct callers keep working unchanged.\n     */\n    async stop(_ctx?: PluginContext): Promise<void> {\n        await this.destroy();\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -150,13 +150,40 @@ var ConnectorSlackPlugin = class {
     this.connectorName = def.name;
     ctx.logger.info(`ConnectorSlackPlugin: Slack connector '${def.name}' registered`);
   }
-  async stop(_ctx) {
+  /**
+   * The kernel's teardown hook (`Plugin.destroy?()`, core `types.ts`) — the
+   * ONLY teardown entry point `ObjectKernel.performShutdown()` and
+   * `LiteKernel.destroy()` invoke.
+   *
+   * [#10371] IT USED TO BE `stop()`, WHICH NOTHING CALLED. `Plugin` declares
+   * `init()`, `start?()` and `destroy?()` and no `stop()`, so the kernel
+   * walked past this plugin at shutdown and the Slack connector stayed registered in the automation
+   * engine for the lifetime of the process. `start()` IS on the
+   * interface, so the pair read as symmetric in review — that asymmetry is
+   * what let the same shape survive in six packages at once.
+   *
+   * No timers here, so this instance never cost a merge-queue eviction the
+   * way the `plugin-reports` / `service-messaging` members did (#9371). The
+   * class is the same one either way: a teardown the kernel does not reach.
+   */
+  async destroy() {
     if (this.automation && this.connectorName) {
       try {
         this.automation.unregisterConnector(this.connectorName);
       } catch {
       }
     }
+    this.automation = void 0;
+    this.connectorName = void 0;
+  }
+  /**
+   * Retained alias for {@link destroy}. Kept because it is public API of an
+   * exported class, and removing it would break an embedder who learned to
+   * call it directly precisely BECAUSE the kernel never did. Prefer kernel
+   * shutdown; direct callers keep working unchanged.
+   */
+  async stop(_ctx) {
+    await this.destroy();
   }
 };
 export {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/slack-connector.ts","../src/connector-slack-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Connector } from '@objectstack/spec/integration';\nimport { resilientFetch } from '@objectstack/spec/shared';\n\n/**\n * Slack connector — a *concrete* connector (ADR-0018 §Addendum) and the second\n * reference implementation after `@objectstack/connector-rest`. It produces a\n * {@link Connector} definition plus handlers for a small set of Slack Web API\n * actions, which the baseline `connector_action` node dispatches to.\n *\n * Scope (ADR-0022 \"raw API call\" path): this is the *integration mechanism*\n * for talking to Slack's API — \"post this exact text to this channel\". It is\n * deliberately **not** the human-notification layer: there is no preference\n * matrix, inbox, outbox, or thread/session semantics here. Those belong to a\n * `MessagingChannel` (ADR-0012/0013), which may itself delegate its transport\n * to this connector.\n *\n * Open-source scope: **static** auth only — a Slack **bot token** (`xoxb-…`),\n * supplied by the caller and sent as a bearer credential. OAuth2 install/refresh,\n * credential vaulting, and multi-tenant connection lifecycle are the enterprise\n * tier (see `../cloud/docs/design/connector-tiering.md`) and are out of scope.\n *\n * Slack quirk: the Web API returns HTTP `200` even on logical failure, with the\n * real outcome in the JSON body's `ok` field (and `error` on failure). Handlers\n * therefore surface `ok` from the payload, not from the HTTP status, and never\n * throw on a logical failure — the flow author branches on `${node.ok}`.\n */\n\nexport interface SlackConnectorOptions {\n    /** Connector machine name (snake_case). Defaults to `slack`. */\n    name?: string;\n    /** Human-readable label. Defaults to `Slack`. */\n    label?: string;\n    /** Slack bot token (`xoxb-…`), sent as `Authorization: Bearer <token>`. */\n    token: string;\n    /** Web API base URL. Defaults to `https://slack.com/api`. */\n    baseUrl?: string;\n    /** Headers merged into every request (request-level headers win). */\n    defaultHeaders?: Record<string, string>;\n    /** Injected for tests; defaults to the global `fetch`. */\n    fetchImpl?: typeof fetch;\n}\n\n/** Input accepted by `chat.postMessage`. */\nexport interface SlackPostMessageInput {\n    /** Channel id (`C…`), user id (`U…`), or channel name (`#general`). */\n    channel: string;\n    /** Message text (fallback when `blocks` are present). */\n    text?: string;\n    /** Thread root `ts` to reply into an existing thread. */\n    thread_ts?: string;\n    /** Block Kit blocks. */\n    blocks?: unknown[];\n    [key: string]: unknown;\n}\n\n/** Generic Slack Web API result envelope. */\nexport interface SlackResult {\n    /** Slack's logical success flag (from the JSON body, not the HTTP status). */\n    ok: boolean;\n    /** HTTP status (almost always 200 for the Slack Web API). */\n    status: number;\n    /** Full parsed Slack payload. */\n    body: Record<string, unknown>;\n    /** Slack error code when `ok` is false (e.g. `channel_not_found`). */\n    error?: string;\n}\n\n/** A connector definition paired with its action handlers, ready for registerConnector(). */\nexport interface SlackConnectorBundle {\n    def: Connector;\n    handlers: Record<\n        string,\n        (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n    >;\n}\n\nexport function createSlackConnector(opts: SlackConnectorOptions): SlackConnectorBundle {\n    const name = opts.name ?? 'slack';\n    const baseUrl = (opts.baseUrl ?? 'https://slack.com/api').replace(/\\/+$/, '');\n\n    const def: Connector = {\n        name,\n        label: opts.label ?? 'Slack',\n        type: 'api',\n        description: 'Slack Web API connector (static bot-token auth). Post and update messages, or call any Web API method.',\n        icon: 'slack',\n        authentication: { type: 'bearer', token: opts.token },\n        // Defaulted by ConnectorSchema; set explicitly so the literal satisfies\n        // the (post-parse) Connector output type.\n        status: 'active',\n        enabled: true,\n        connectionTimeoutMs: 30000,\n        requestTimeoutMs: 30000,\n        actions: [\n            {\n                key: 'chat.postMessage',\n                label: 'Post Message',\n                description: 'Post a message to a channel, DM, or thread (Slack chat.postMessage).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id, user id, or #name' },\n                        text: { type: 'string', description: 'Message text' },\n                        thread_ts: { type: 'string', description: 'Thread root ts to reply into' },\n                        blocks: { type: 'array', description: 'Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'chat.update',\n                label: 'Update Message',\n                description: 'Edit an existing message (Slack chat.update).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel', 'ts'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id' },\n                        ts: { type: 'string', description: 'Timestamp of the message to update' },\n                        text: { type: 'string', description: 'New message text' },\n                        blocks: { type: 'array', description: 'New Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'call',\n                label: 'Call Web API Method',\n                description: 'Escape hatch — call any Slack Web API method with arbitrary params.',\n                inputSchema: {\n                    type: 'object',\n                    required: ['method'],\n                    properties: {\n                        method: { type: 'string', description: 'Web API method, e.g. conversations.list' },\n                        params: { type: 'object', description: 'Method parameters (JSON body)' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n        ],\n    };\n\n    /** POST a JSON body to a Slack Web API method and normalise the result. */\n    async function callSlack(method: string, params: Record<string, unknown>): Promise<SlackResult> {\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json; charset=utf-8',\n            ...opts.defaultHeaders,\n            Authorization: `Bearer ${opts.token}`,\n        };\n\n        const response = await resilientFetch(`${baseUrl}/${method}`, {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n        }, { fetchImpl: opts.fetchImpl });\n\n        // The Slack Web API always answers with JSON; `ok` is the real outcome.\n        const body = (await response.json()) as Record<string, unknown>;\n        const ok = body.ok === true;\n        return {\n            ok,\n            status: response.status,\n            body,\n            error: ok ? undefined : (body.error as string | undefined),\n        };\n    }\n\n    async function postMessage(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.postMessage', input));\n    }\n\n    async function update(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.update', input));\n    }\n\n    async function call(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        const method = String(input.method ?? '');\n        if (!method) throw new Error(\"slack 'call' action: 'method' is required\");\n        const params = (input.params as Record<string, unknown>) ?? {};\n        return toRecord(await callSlack(method, params));\n    }\n\n    return {\n        def,\n        handlers: {\n            'chat.postMessage': postMessage,\n            'chat.update': update,\n            call,\n        },\n    };\n}\n\nfunction toRecord(r: SlackResult): Record<string, unknown> {\n    return { ok: r.ok, status: r.status, body: r.body, error: r.error };\n}\n\nfunction slackOutputSchema(): Record<string, unknown> {\n    return {\n        type: 'object',\n        properties: {\n            ok: { type: 'boolean', description: \"Slack's logical success flag\" },\n            status: { type: 'number', description: 'HTTP status' },\n            body: { type: 'object', description: 'Full Slack response payload' },\n            error: { type: 'string', description: 'Slack error code when ok is false' },\n        },\n    };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { Connector } from '@objectstack/spec/integration';\nimport { createSlackConnector, type SlackConnectorOptions } from './slack-connector.js';\n\n/**\n * Minimal surface of the automation engine this plugin depends on — the\n * connector registry from ADR-0018 §Addendum. Kept structural so the plugin\n * needs no runtime dependency on `@objectstack/service-automation`.\n */\nexport interface ConnectorRegistrySurface {\n    registerConnector(\n        def: Connector,\n        handlers: Record<\n            string,\n            (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n        >,\n    ): void;\n    unregisterConnector(name: string): void;\n}\n\nexport interface ConnectorSlackPluginOptions extends SlackConnectorOptions {}\n\n/**\n * ConnectorSlackPlugin — registers a Slack Web API connector on the automation\n * engine. The second reference concrete connector (ADR-0018 §Addendum); it\n * enables the ADR-0022 \"raw API call\" path — a flow's `connector_action` step\n * can dispatch to `slack.chat.postMessage` without the messaging stack.\n *\n * If no automation engine is present the plugin logs and skips — the connector\n * has nowhere to register, which is not an error.\n */\nexport class ConnectorSlackPlugin implements Plugin {\n    name = 'com.objectstack.connector.slack';\n    version = '1.0.0';\n    type = 'standard' as const;\n    // Ensure the automation engine (and its connector registry) is started first.\n    dependencies = ['com.objectstack.service-automation'];\n\n    private readonly options: ConnectorSlackPluginOptions;\n    private connectorName?: string;\n    private automation?: ConnectorRegistrySurface;\n\n    constructor(options: ConnectorSlackPluginOptions) {\n        this.options = options;\n    }\n\n    async init(_ctx: PluginContext): Promise<void> {\n        // No services to register; the connector is registered in start() once\n        // the automation engine is available.\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        let automation: ConnectorRegistrySurface | undefined;\n        try {\n            automation = ctx.getService<ConnectorRegistrySurface>('automation');\n        } catch {\n            automation = undefined;\n        }\n\n        if (!automation || typeof automation.registerConnector !== 'function') {\n            ctx.logger.info('ConnectorSlackPlugin: no automation engine — Slack connector not registered');\n            return;\n        }\n\n        const { def, handlers } = createSlackConnector(this.options);\n        automation.registerConnector(def, handlers);\n        this.automation = automation;\n        this.connectorName = def.name;\n        ctx.logger.info(`ConnectorSlackPlugin: Slack connector '${def.name}' registered`);\n    }\n\n    async stop(_ctx: PluginContext): Promise<void> {\n        if (this.automation && this.connectorName) {\n            try { this.automation.unregisterConnector(this.connectorName); } catch { /* ignore */ }\n        }\n    }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/slack-connector.ts","../src/connector-slack-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Connector } from '@objectstack/spec/integration';\nimport { resilientFetch } from '@objectstack/spec/shared';\n\n/**\n * Slack connector — a *concrete* connector (ADR-0018 §Addendum) and the second\n * reference implementation after `@objectstack/connector-rest`. It produces a\n * {@link Connector} definition plus handlers for a small set of Slack Web API\n * actions, which the baseline `connector_action` node dispatches to.\n *\n * Scope (ADR-0022 \"raw API call\" path): this is the *integration mechanism*\n * for talking to Slack's API — \"post this exact text to this channel\". It is\n * deliberately **not** the human-notification layer: there is no preference\n * matrix, inbox, outbox, or thread/session semantics here. Those belong to a\n * `MessagingChannel` (ADR-0012/0013), which may itself delegate its transport\n * to this connector.\n *\n * Open-source scope: **static** auth only — a Slack **bot token** (`xoxb-…`),\n * supplied by the caller and sent as a bearer credential. OAuth2 install/refresh,\n * credential vaulting, and multi-tenant connection lifecycle are the enterprise\n * tier (see `../cloud/docs/design/connector-tiering.md`) and are out of scope.\n *\n * Slack quirk: the Web API returns HTTP `200` even on logical failure, with the\n * real outcome in the JSON body's `ok` field (and `error` on failure). Handlers\n * therefore surface `ok` from the payload, not from the HTTP status, and never\n * throw on a logical failure — the flow author branches on `${node.ok}`.\n */\n\nexport interface SlackConnectorOptions {\n    /** Connector machine name (snake_case). Defaults to `slack`. */\n    name?: string;\n    /** Human-readable label. Defaults to `Slack`. */\n    label?: string;\n    /** Slack bot token (`xoxb-…`), sent as `Authorization: Bearer <token>`. */\n    token: string;\n    /** Web API base URL. Defaults to `https://slack.com/api`. */\n    baseUrl?: string;\n    /** Headers merged into every request (request-level headers win). */\n    defaultHeaders?: Record<string, string>;\n    /** Injected for tests; defaults to the global `fetch`. */\n    fetchImpl?: typeof fetch;\n}\n\n/** Input accepted by `chat.postMessage`. */\nexport interface SlackPostMessageInput {\n    /** Channel id (`C…`), user id (`U…`), or channel name (`#general`). */\n    channel: string;\n    /** Message text (fallback when `blocks` are present). */\n    text?: string;\n    /** Thread root `ts` to reply into an existing thread. */\n    thread_ts?: string;\n    /** Block Kit blocks. */\n    blocks?: unknown[];\n    [key: string]: unknown;\n}\n\n/** Generic Slack Web API result envelope. */\nexport interface SlackResult {\n    /** Slack's logical success flag (from the JSON body, not the HTTP status). */\n    ok: boolean;\n    /** HTTP status (almost always 200 for the Slack Web API). */\n    status: number;\n    /** Full parsed Slack payload. */\n    body: Record<string, unknown>;\n    /** Slack error code when `ok` is false (e.g. `channel_not_found`). */\n    error?: string;\n}\n\n/** A connector definition paired with its action handlers, ready for registerConnector(). */\nexport interface SlackConnectorBundle {\n    def: Connector;\n    handlers: Record<\n        string,\n        (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n    >;\n}\n\nexport function createSlackConnector(opts: SlackConnectorOptions): SlackConnectorBundle {\n    const name = opts.name ?? 'slack';\n    const baseUrl = (opts.baseUrl ?? 'https://slack.com/api').replace(/\\/+$/, '');\n\n    const def: Connector = {\n        name,\n        label: opts.label ?? 'Slack',\n        type: 'api',\n        description: 'Slack Web API connector (static bot-token auth). Post and update messages, or call any Web API method.',\n        icon: 'slack',\n        authentication: { type: 'bearer', token: opts.token },\n        // Defaulted by ConnectorSchema; set explicitly so the literal satisfies\n        // the (post-parse) Connector output type.\n        status: 'active',\n        enabled: true,\n        connectionTimeoutMs: 30000,\n        requestTimeoutMs: 30000,\n        actions: [\n            {\n                key: 'chat.postMessage',\n                label: 'Post Message',\n                description: 'Post a message to a channel, DM, or thread (Slack chat.postMessage).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id, user id, or #name' },\n                        text: { type: 'string', description: 'Message text' },\n                        thread_ts: { type: 'string', description: 'Thread root ts to reply into' },\n                        blocks: { type: 'array', description: 'Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'chat.update',\n                label: 'Update Message',\n                description: 'Edit an existing message (Slack chat.update).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel', 'ts'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id' },\n                        ts: { type: 'string', description: 'Timestamp of the message to update' },\n                        text: { type: 'string', description: 'New message text' },\n                        blocks: { type: 'array', description: 'New Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'call',\n                label: 'Call Web API Method',\n                description: 'Escape hatch — call any Slack Web API method with arbitrary params.',\n                inputSchema: {\n                    type: 'object',\n                    required: ['method'],\n                    properties: {\n                        method: { type: 'string', description: 'Web API method, e.g. conversations.list' },\n                        params: { type: 'object', description: 'Method parameters (JSON body)' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n        ],\n    };\n\n    /** POST a JSON body to a Slack Web API method and normalise the result. */\n    async function callSlack(method: string, params: Record<string, unknown>): Promise<SlackResult> {\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json; charset=utf-8',\n            ...opts.defaultHeaders,\n            Authorization: `Bearer ${opts.token}`,\n        };\n\n        const response = await resilientFetch(`${baseUrl}/${method}`, {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n        }, { fetchImpl: opts.fetchImpl });\n\n        // The Slack Web API always answers with JSON; `ok` is the real outcome.\n        const body = (await response.json()) as Record<string, unknown>;\n        const ok = body.ok === true;\n        return {\n            ok,\n            status: response.status,\n            body,\n            error: ok ? undefined : (body.error as string | undefined),\n        };\n    }\n\n    async function postMessage(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.postMessage', input));\n    }\n\n    async function update(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.update', input));\n    }\n\n    async function call(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        const method = String(input.method ?? '');\n        if (!method) throw new Error(\"slack 'call' action: 'method' is required\");\n        const params = (input.params as Record<string, unknown>) ?? {};\n        return toRecord(await callSlack(method, params));\n    }\n\n    return {\n        def,\n        handlers: {\n            'chat.postMessage': postMessage,\n            'chat.update': update,\n            call,\n        },\n    };\n}\n\nfunction toRecord(r: SlackResult): Record<string, unknown> {\n    return { ok: r.ok, status: r.status, body: r.body, error: r.error };\n}\n\nfunction slackOutputSchema(): Record<string, unknown> {\n    return {\n        type: 'object',\n        properties: {\n            ok: { type: 'boolean', description: \"Slack's logical success flag\" },\n            status: { type: 'number', description: 'HTTP status' },\n            body: { type: 'object', description: 'Full Slack response payload' },\n            error: { type: 'string', description: 'Slack error code when ok is false' },\n        },\n    };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { Connector } from '@objectstack/spec/integration';\nimport { createSlackConnector, type SlackConnectorOptions } from './slack-connector.js';\n\n/**\n * Minimal surface of the automation engine this plugin depends on — the\n * connector registry from ADR-0018 §Addendum. Kept structural so the plugin\n * needs no runtime dependency on `@objectstack/service-automation`.\n */\nexport interface ConnectorRegistrySurface {\n    registerConnector(\n        def: Connector,\n        handlers: Record<\n            string,\n            (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n        >,\n    ): void;\n    unregisterConnector(name: string): void;\n}\n\nexport interface ConnectorSlackPluginOptions extends SlackConnectorOptions {}\n\n/**\n * ConnectorSlackPlugin — registers a Slack Web API connector on the automation\n * engine. The second reference concrete connector (ADR-0018 §Addendum); it\n * enables the ADR-0022 \"raw API call\" path — a flow's `connector_action` step\n * can dispatch to `slack.chat.postMessage` without the messaging stack.\n *\n * If no automation engine is present the plugin logs and skips — the connector\n * has nowhere to register, which is not an error.\n */\nexport class ConnectorSlackPlugin implements Plugin {\n    name = 'com.objectstack.connector.slack';\n    version = '1.0.0';\n    type = 'standard' as const;\n    // Ensure the automation engine (and its connector registry) is started first.\n    dependencies = ['com.objectstack.service-automation'];\n\n    private readonly options: ConnectorSlackPluginOptions;\n    private connectorName?: string;\n    private automation?: ConnectorRegistrySurface;\n\n    constructor(options: ConnectorSlackPluginOptions) {\n        this.options = options;\n    }\n\n    async init(_ctx: PluginContext): Promise<void> {\n        // No services to register; the connector is registered in start() once\n        // the automation engine is available.\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        let automation: ConnectorRegistrySurface | undefined;\n        try {\n            automation = ctx.getService<ConnectorRegistrySurface>('automation');\n        } catch {\n            automation = undefined;\n        }\n\n        if (!automation || typeof automation.registerConnector !== 'function') {\n            ctx.logger.info('ConnectorSlackPlugin: no automation engine — Slack connector not registered');\n            return;\n        }\n\n        const { def, handlers } = createSlackConnector(this.options);\n        automation.registerConnector(def, handlers);\n        this.automation = automation;\n        this.connectorName = def.name;\n        ctx.logger.info(`ConnectorSlackPlugin: Slack connector '${def.name}' registered`);\n    }\n\n    /**\n     * The kernel's teardown hook (`Plugin.destroy?()`, core `types.ts`) — the\n     * ONLY teardown entry point `ObjectKernel.performShutdown()` and\n     * `LiteKernel.destroy()` invoke.\n     *\n     * [#10371] IT USED TO BE `stop()`, WHICH NOTHING CALLED. `Plugin` declares\n     * `init()`, `start?()` and `destroy?()` and no `stop()`, so the kernel\n     * walked past this plugin at shutdown and the Slack connector stayed registered in the automation\n     * engine for the lifetime of the process. `start()` IS on the\n     * interface, so the pair read as symmetric in review — that asymmetry is\n     * what let the same shape survive in six packages at once.\n     *\n     * No timers here, so this instance never cost a merge-queue eviction the\n     * way the `plugin-reports` / `service-messaging` members did (#9371). The\n     * class is the same one either way: a teardown the kernel does not reach.\n     */\n    async destroy(): Promise<void> {\n        if (this.automation && this.connectorName) {\n            try { this.automation.unregisterConnector(this.connectorName); } catch { /* ignore */ }\n        }\n        this.automation = undefined;\n        this.connectorName = undefined;\n    }\n\n    /**\n     * Retained alias for {@link destroy}. Kept because it is public API of an\n     * exported class, and removing it would break an embedder who learned to\n     * call it directly precisely BECAUSE the kernel never did. Prefer kernel\n     * shutdown; direct callers keep working unchanged.\n     */\n    async stop(_ctx?: PluginContext): Promise<void> {\n        await this.destroy();\n    }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/connector-slack",
-  "version": "17.0.0",
+  "version": "17.2.0",
   "license": "Apache-2.0",
   "description": "Slack Web API connector for ObjectStack — registers `chat.postMessage` / `chat.update` / `call` actions on the automation engine's connector registry (ADR-0018 §Addendum, ADR-0022).",
   "main": "dist/index.js",
@@ -13,14 +13,14 @@
     }
   },
   "dependencies": {
-    "@objectstack/core": "17.0.0",
-    "@objectstack/spec": "17.0.0"
+    "@objectstack/core": "17.2.0",
+    "@objectstack/spec": "17.2.0"
   },
   "devDependencies": {
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "@objectstack/service-automation": "17.0.0"
+    "@objectstack/service-automation": "17.2.0"
   },
   "keywords": [
     "objectstack",