@openclaw/slack 2026.7.2-beta.2 → 2026.7.2-beta.4

package/dist/{setup-surface-oSd3NX9J.js → setup-surface-wV-S1dE_.js}

@@ -1,14 +1,18 @@
-import { a as resolveSlackAccount, i as resolveDefaultSlackAccountId, o as resolveSlackAccountAllowFrom } from "./accounts-BOJJiHSr.js";
-import "./shared-D9yz5Otg.js";
-import { i as SLACK_CHANNEL, t as createSlackSetupWizardBase } from "./setup-core-CkwVLzFO.js";
-import { t as resolveSlackChannelAllowlist } from "./resolve-channels-Rfts6POK.js";
-import { t as resolveSlackUserAllowlist } from "./resolve-users-y6wAxR8E.js";
+import { i as resolveDefaultSlackAccountId, o as resolveSlackAccountAllowFrom } from "./accounts-BSr252c_.js";
+import { t as inspectSlackAccount } from "./account-inspect-jn1xLaVi.js";
+import "./shared-BfMskaMx.js";
+import { a as SLACK_CHANNEL, t as createSlackSetupWizardBase } from "./setup-core-tPxMuFez.js";
+import { t as resolveSlackChannelAllowlist } from "./resolve-channels-DodP2TFx.js";
+import { t as resolveSlackUserAllowlist } from "./resolve-users-M9eF8891.js";
 import { normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { adaptScopedAccountAccessor } from "openclaw/plugin-sdk/channel-config-helpers";
-import { createSetupTranslator, noteChannelLookupFailure, noteChannelLookupSummary, parseMentionOrPrefixedId, promptLegacyChannelAllowFromForAccount, resolveEntriesWithOptionalToken } from "openclaw/plugin-sdk/setup-runtime";
+import { createSetupTranslator, noteChannelLookupFailure, noteChannelLookupSummary, parseMentionOrPrefixedId, patchChannelConfigForAccount, promptResolvedAllowFrom, resolveEntriesWithOptionalToken, resolveSetupAccountId, splitSetupEntries } from "openclaw/plugin-sdk/setup-runtime";
 import { formatDocsLink } from "openclaw/plugin-sdk/setup-tools";
 //#region extensions/slack/src/setup-surface.ts
 const t = createSetupTranslator();
+function resolveSlackSetupAuth(account, credentialValues) {
+	if (account.config.postAs === "user") return credentialValues.userToken || account.userToken;
+	return credentialValues.botToken || account.botToken;
+}
 async function resolveSlackAllowFromEntries(params) {
 	return await resolveEntriesWithOptionalToken({
 		token: params.token,
@@ -36,29 +40,34 @@ async function promptSlackAllowFrom(params) {
 		idPattern: /^[A-Z][A-Z0-9]+$/i,
 		normalizeId: (id) => id.toUpperCase()
 	});
-	return await promptLegacyChannelAllowFromForAccount({
+	const accountId = resolveSetupAccountId({
+		accountId: params.accountId,
+		defaultAccountId: resolveDefaultSlackAccountId(params.cfg)
+	});
+	const account = inspectSlackAccount({
 		cfg: params.cfg,
-		channel: SLACK_CHANNEL,
+		accountId
+	});
+	const noteTitle = t("wizard.slack.allowlistTitle");
+	await params.prompter.note([
+		t("wizard.slack.allowlistIntro"),
+		t("wizard.slack.examples"),
+		"- U12345678",
+		"- @alice",
+		t("wizard.slack.multipleEntries"),
+		t("wizard.channels.docs", { link: formatDocsLink("/slack", "slack") })
+	].join("\n"), noteTitle);
+	const allowFrom = await promptResolvedAllowFrom({
 		prompter: params.prompter,
-		accountId: params.accountId,
-		defaultAccountId: resolveDefaultSlackAccountId(params.cfg),
-		resolveAccount: adaptScopedAccountAccessor(resolveSlackAccount),
-		resolveExisting: (account, cfg) => resolveSlackAccountAllowFrom({
-			cfg,
-			accountId: account.accountId
+		existing: resolveSlackAccountAllowFrom({
+			cfg: params.cfg,
+			accountId
 		}) ?? [],
-		resolveToken: (account) => account.userToken ?? account.botToken ?? "",
-		noteTitle: t("wizard.slack.allowlistTitle"),
-		noteLines: [
-			t("wizard.slack.allowlistIntro"),
-			t("wizard.slack.examples"),
-			"- U12345678",
-			"- @alice",
-			t("wizard.slack.multipleEntries"),
-			t("wizard.channels.docs", { link: formatDocsLink("/slack", "slack") })
-		],
+		token: account.userToken ?? account.botToken ?? "",
 		message: t("wizard.slack.allowFromPrompt"),
 		placeholder: "@alice, U12345678",
+		label: noteTitle,
+		parseInputs: splitSetupEntries,
 		parseId,
 		invalidWithoutTokenNote: t("wizard.slack.allowFromInvalidWithoutToken"),
 		resolveEntries: async ({ token, entries }) => (await resolveSlackUserAllowlist({
@@ -70,16 +79,28 @@ async function promptSlackAllowFrom(params) {
 			id: entry.id ?? null
 		}))
 	});
+	return patchChannelConfigForAccount({
+		cfg: params.cfg,
+		channel: SLACK_CHANNEL,
+		accountId: account.accountId,
+		patch: {
+			allowFrom,
+			dm: {
+				...account.config.dm,
+				enabled: typeof account.config.dm?.enabled === "boolean" ? account.config.dm.enabled : true
+			}
+		}
+	});
 }
 async function resolveSlackGroupAllowlist(params) {
 	let keys = params.entries;
-	const activeBotToken = resolveSlackAccount({
+	const auth = resolveSlackSetupAuth(inspectSlackAccount({
 		cfg: params.cfg,
 		accountId: params.accountId
-	}).botToken || params.credentialValues.botToken || "";
+	}), params.credentialValues) || "";
 	if (params.entries.length > 0) try {
 		const resolved = await resolveEntriesWithOptionalToken({
-			token: activeBotToken,
+			token: auth,
 			entries: params.entries,
 			buildWithoutToken: (input) => ({
 				input,
@@ -114,10 +135,15 @@ async function resolveSlackGroupAllowlist(params) {
 }
 const slackSetupWizard = createSlackSetupWizardBase({
 	promptAllowFrom: promptSlackAllowFrom,
-	resolveAllowFromEntries: async ({ credentialValues, entries }) => await resolveSlackAllowFromEntries({
-		token: credentialValues.botToken,
-		entries
-	}),
+	resolveAllowFromEntries: async ({ cfg, accountId, credentialValues, entries }) => {
+		return await resolveSlackAllowFromEntries({
+			token: resolveSlackSetupAuth(inspectSlackAccount({
+				cfg,
+				accountId
+			}), credentialValues),
+			entries
+		});
+	},
 	resolveGroupAllowlist: async ({ cfg, accountId, credentialValues, entries, prompter }) => await resolveSlackGroupAllowlist({
 		cfg,
 		accountId,

package/dist/{shared-D9yz5Otg.js → shared-BfMskaMx.js}

@@ -1,12 +1,12 @@
-import { a as resolveSlackAccount, c as resolveSlackConfigAccessorAccount, i as resolveDefaultSlackAccountId, n as listSlackAccountIds, o as resolveSlackAccountAllowFrom, r as mergeSlackAccountConfig, s as resolveSlackAccountDmPolicy } from "./accounts-BOJJiHSr.js";
-import { t as inspectSlackAccount } from "./account-inspect-Di7ditqZ.js";
-import { t as isSlackPluginAccountConfigured } from "./account-configured-DzC407uv.js";
-import { n as isSlackInteractiveRepliesEnabled } from "./interactive-replies-BilWUdcI.js";
-import { h as getChatChannelMeta } from "./client-WIPAS3Yr.js";
-import { i as SLACK_CHANNEL } from "./setup-core-CkwVLzFO.js";
-import { t as SlackChannelConfigSchema } from "./config-schema-xPSnK2VK.js";
-import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-DddfkMlF.js";
-import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-CMohXFWS.js";
+import { a as resolveSlackAccount, c as resolveSlackConfigAccessorAccount, i as resolveDefaultSlackAccountId, n as listSlackAccountIds, o as resolveSlackAccountAllowFrom, r as mergeSlackAccountConfig, s as resolveSlackAccountDmPolicy } from "./accounts-BSr252c_.js";
+import { t as inspectSlackAccount } from "./account-inspect-jn1xLaVi.js";
+import { t as isSlackPluginAccountConfigured } from "./account-configured-BwfXBo_F.js";
+import { n as isSlackInteractiveRepliesEnabled } from "./interactive-replies-C3ffk6oN.js";
+import { t as probeSlack, v as getChatChannelMeta } from "./probe-CVRuArHA.js";
+import { a as SLACK_CHANNEL } from "./setup-core-tPxMuFez.js";
+import { t as SlackChannelConfigSchema } from "./config-schema-B4j4tCOI.js";
+import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-U6oVntbM.js";
+import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-DxmvbxBF.js";
 import { adaptScopedAccountAccessor, createScopedChannelConfigAdapter, createScopedDmSecurityResolver } from "openclaw/plugin-sdk/channel-config-helpers";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { formatAllowFromLowercase } from "openclaw/plugin-sdk/allow-from";
@@ -46,7 +46,7 @@ const collectSlackSecurityWarnings = createOpenProviderConfiguredRouteWarningCol
 		remediation: "Set channels.slack.groupPolicy=\"allowlist\" and configure channels.slack.channels"
 	}
 });
-const loadSlackSecurityAuditModule = createLazyRuntimeModule(() => import("./security-audit-CikQhBUY.js").then((n) => n.n));
+const loadSlackSecurityAuditModule = createLazyRuntimeModule(() => import("./security-audit-Cz6erklv.js").then((n) => n.n));
 const slackSecurityAdapter = {
 	resolveDmPolicy: resolveSlackDmPolicy,
 	collectWarnings: collectSlackSecurityWarnings,
@@ -135,6 +135,46 @@ function collectSlackNameKeyedChannelWarnings({ cfg }) {
 	}
 	return [...warnings];
 }
+function slackAccountConfigPath(accountId) {
+	return accountId === "default" ? "channels.slack" : `channels.slack.accounts.${accountId}`;
+}
+async function collectSlackUserIdentityWarnings(params) {
+	const warnings = [];
+	for (const accountId of listSlackAccountIds(params.cfg)) {
+		const account = inspectSlackAccount({
+			cfg: params.cfg,
+			accountId,
+			envBotToken: params.env?.SLACK_BOT_TOKEN,
+			envAppToken: params.env?.SLACK_APP_TOKEN,
+			envUserToken: params.env?.SLACK_USER_TOKEN
+		});
+		if (!account.enabled || account.identity !== "user") continue;
+		const path = slackAccountConfigPath(accountId);
+		const mode = account.mode ?? "socket";
+		if (mode === "socket" && account.appTokenStatus === "missing") warnings.push(`- ${path}: identity "user" in Socket Mode requires appToken for companion-app events.`);
+		else if (mode === "http" && account.signingSecretStatus === "missing") warnings.push(`- ${path}: identity "user" in HTTP mode requires signingSecret for companion-app events.`);
+		if (!account.userToken) {
+			warnings.push(account.userTokenStatus === "configured_unavailable" ? `- ${path}: userToken is configured but unavailable; Slack auth.test validation was skipped.` : `- ${path}: identity "user" requires userToken for the authorizing human.`);
+			continue;
+		}
+		const probe = await probeSlack(account.userToken, 2500, {
+			accountId,
+			identity: "user"
+		});
+		if (!probe.ok) {
+			warnings.push(`- ${path}: userToken auth.test failed: ${probe.error ?? "unknown error"}.`);
+			continue;
+		}
+		const userId = probe.user?.id?.trim();
+		const userName = probe.user?.name?.trim();
+		if (!userId) {
+			warnings.push(`- ${path}: userToken auth.test succeeded but returned no human user_id.`);
+			continue;
+		}
+		warnings.push(`- ${path}: user identity authenticated as ${userName ? `@${userName} ` : ""}(${userId}).`);
+	}
+	return warnings;
+}
 const slackDoctor = {
 	dmAllowFromMode: "topOnly",
 	groupModel: "route",
@@ -142,6 +182,10 @@ const slackDoctor = {
 	warnOnEmptyGroupSenderAllowlist: false,
 	legacyConfigRules,
 	normalizeCompatibilityConfig,
+	collectPreviewWarnings: async ({ cfg, env }) => await collectSlackUserIdentityWarnings({
+		cfg,
+		env
+	}),
 	collectMutableAllowlistWarnings: ({ cfg }) => [...collectSlackMutableAllowlistWarnings({ cfg }), ...collectSlackNameKeyedChannelWarnings({ cfg })]
 };
 //#endregion
@@ -156,6 +200,8 @@ const slackConfigAdapter = createScopedChannelConfigAdapter({
 	clearBaseFields: [
 		"botToken",
 		"appToken",
+		"userToken",
+		"signingSecret",
 		"name"
 	],
 	resolveAllowFrom: (account) => account.allowFrom,
@@ -170,6 +216,7 @@ function createSlackPluginBase(params) {
 			preferSessionLookupForAnnounceTarget: true
 		},
 		setupWizard: params.setupWizard,
+		...params.setupContract ? { setupContract: params.setupContract } : {},
 		capabilities: {
 			chatTypes: [
 				"direct",

package/dist/{slash-dispatch.runtime-CSja9VuD.js → slash-dispatch.runtime-lfeIsXTX.js}

@@ -1,4 +1,4 @@
-import { r as deliverSlackSlashReplies$1 } from "./replies-CJJCp6qz.js";
+import { r as deliverSlackSlashReplies$1 } from "./replies-Cgr2Gli4.js";
 import { resolveAgentRoute as resolveAgentRoute$1 } from "openclaw/plugin-sdk/routing";
 import { resolveMarkdownTableMode as resolveMarkdownTableMode$1 } from "openclaw/plugin-sdk/markdown-table-runtime";
 import { recordInboundSessionMetaSafe as recordInboundSessionMetaSafe$1, resolveConversationLabel as resolveConversationLabel$1 } from "openclaw/plugin-sdk/conversation-runtime";

package/node_modules/@types/node/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for node (https://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Wed, 01 Jul 2026 11:03:38 GMT
+ * Last updated: Wed, 08 Jul 2026 06:47:45 GMT
  * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
 
 # Credits

package/node_modules/@types/node/fs/promises.d.ts

@@ -153,7 +153,11 @@ declare module "node:fs/promises" {
          * @return Fulfills with `undefined` upon success.
          */
         appendFile(
-            data: string | Uint8Array,
+            data:
+                | string
+                | NodeJS.ArrayBufferView
+                | Iterable<string | NodeJS.ArrayBufferView>
+                | AsyncIterable<string | NodeJS.ArrayBufferView>,
             options?:
                 | (ObjectEncodingOptions & Abortable)
                 | BufferEncoding
@@ -470,7 +474,11 @@ declare module "node:fs/promises" {
          * @since v10.0.0
          */
         writeFile(
-            data: string | Uint8Array,
+            data:
+                | string
+                | NodeJS.ArrayBufferView
+                | Iterable<string | NodeJS.ArrayBufferView>
+                | AsyncIterable<string | NodeJS.ArrayBufferView>,
             options?:
                 | (ObjectEncodingOptions & Abortable)
                 | BufferEncoding
@@ -1208,8 +1216,7 @@ declare module "node:fs/promises" {
             | string
             | NodeJS.ArrayBufferView
             | Iterable<string | NodeJS.ArrayBufferView>
-            | AsyncIterable<string | NodeJS.ArrayBufferView>
-            | Stream,
+            | AsyncIterable<string | NodeJS.ArrayBufferView>,
         options?:
             | (ObjectEncodingOptions & {
                 mode?: Mode | undefined;
@@ -1240,7 +1247,11 @@ declare module "node:fs/promises" {
      */
     function appendFile(
         path: PathLike | FileHandle,
-        data: string | Uint8Array,
+        data:
+            | string
+            | NodeJS.ArrayBufferView
+            | Iterable<string | NodeJS.ArrayBufferView>
+            | AsyncIterable<string | NodeJS.ArrayBufferView>,
         options?: (ObjectEncodingOptions & FlagAndOpenMode & { flush?: boolean | undefined }) | BufferEncoding | null,
     ): Promise<void>;
     /**
@@ -1432,7 +1443,6 @@ declare module "node:fs/promises" {
      * When copying a directory to another directory, globs are not supported and
      * behavior is similar to `cp dir1/ dir2/`.
      * @since v16.7.0
-     * @experimental
      * @param src source path to copy.
      * @param dest destination path to copy to.
      * @return Fulfills with `undefined` upon success.

package/node_modules/@types/node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "26.1.0",
+    "version": "26.1.1",
     "description": "TypeScript definitions for node",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -150,6 +150,6 @@
         "undici-types": "~8.3.0"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "bac6fe2369bbd2e0f2cf6643373e8c398ed66b886a72749c8d1fb0b9b60031ab",
+    "typesPublisherContentHash": "a59119b073061829bc67a5bf6bc2b8ecb0a5a6196058e3c73172a00440f4e16d",
     "typeScriptVersion": "5.6"
 }

package/node_modules/agent-base/README.md

@@ -0,0 +1,145 @@
+agent-base
+==========
+### Turn a function into an [`http.Agent`][http.Agent] instance
+[![Build Status](https://github.com/TooTallNate/node-agent-base/workflows/Node%20CI/badge.svg)](https://github.com/TooTallNate/node-agent-base/actions?workflow=Node+CI)
+
+This module provides an `http.Agent` generator. That is, you pass it an async
+callback function, and it returns a new `http.Agent` instance that will invoke the
+given callback function when sending outbound HTTP requests.
+
+#### Some subclasses:
+
+Here's some more interesting uses of `agent-base`.
+Send a pull request to list yours!
+
+ * [`http-proxy-agent`][http-proxy-agent]: An HTTP(s) proxy `http.Agent` implementation for HTTP endpoints
+ * [`https-proxy-agent`][https-proxy-agent]: An HTTP(s) proxy `http.Agent` implementation for HTTPS endpoints
+ * [`pac-proxy-agent`][pac-proxy-agent]: A PAC file proxy `http.Agent` implementation for HTTP and HTTPS
+ * [`socks-proxy-agent`][socks-proxy-agent]: A SOCKS proxy `http.Agent` implementation for HTTP and HTTPS
+
+
+Installation
+------------
+
+Install with `npm`:
+
+``` bash
+$ npm install agent-base
+```
+
+
+Example
+-------
+
+Here's a minimal example that creates a new `net.Socket` connection to the server
+for every HTTP request (i.e. the equivalent of `agent: false` option):
+
+```js
+var net = require('net');
+var tls = require('tls');
+var url = require('url');
+var http = require('http');
+var agent = require('agent-base');
+
+var endpoint = 'http://nodejs.org/api/';
+var parsed = url.parse(endpoint);
+
+// This is the important part!
+parsed.agent = agent(function (req, opts) {
+  var socket;
+  // `secureEndpoint` is true when using the https module
+  if (opts.secureEndpoint) {
+    socket = tls.connect(opts);
+  } else {
+    socket = net.connect(opts);
+  }
+  return socket;
+});
+
+// Everything else works just like normal...
+http.get(parsed, function (res) {
+  console.log('"response" event!', res.headers);
+  res.pipe(process.stdout);
+});
+```
+
+Returning a Promise or using an `async` function is also supported:
+
+```js
+agent(async function (req, opts) {
+  await sleep(1000);
+  // etc…
+});
+```
+
+Return another `http.Agent` instance to "pass through" the responsibility
+for that HTTP request to that agent:
+
+```js
+agent(function (req, opts) {
+  return opts.secureEndpoint ? https.globalAgent : http.globalAgent;
+});
+```
+
+
+API
+---
+
+## Agent(Function callback[, Object options]) → [http.Agent][]
+
+Creates a base `http.Agent` that will execute the callback function `callback`
+for every HTTP request that it is used as the `agent` for. The callback function
+is responsible for creating a `stream.Duplex` instance of some kind that will be
+used as the underlying socket in the HTTP request.
+
+The `options` object accepts the following properties:
+
+  * `timeout` - Number - Timeout for the `callback()` function in milliseconds. Defaults to Infinity (optional).
+
+The callback function should have the following signature:
+
+### callback(http.ClientRequest req, Object options, Function cb) → undefined
+
+The ClientRequest `req` can be accessed to read request headers and
+and the path, etc. The `options` object contains the options passed
+to the `http.request()`/`https.request()` function call, and is formatted
+to be directly passed to `net.connect()`/`tls.connect()`, or however
+else you want a Socket to be created. Pass the created socket to
+the callback function `cb` once created, and the HTTP request will
+continue to proceed.
+
+If the `https` module is used to invoke the HTTP request, then the
+`secureEndpoint` property on `options` _will be set to `true`_.
+
+
+License
+-------
+
+(The MIT License)
+
+Copyright (c) 2013 Nathan Rajlich <nathan@tootallnate.net>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+[http-proxy-agent]: https://github.com/TooTallNate/node-http-proxy-agent
+[https-proxy-agent]: https://github.com/TooTallNate/node-https-proxy-agent
+[pac-proxy-agent]: https://github.com/TooTallNate/node-pac-proxy-agent
+[socks-proxy-agent]: https://github.com/TooTallNate/node-socks-proxy-agent
+[http.Agent]: https://nodejs.org/api/http.html#http_class_http_agent

package/node_modules/agent-base/dist/src/index.d.ts

@@ -0,0 +1,78 @@
+/// <reference types="node" />
+import net from 'net';
+import http from 'http';
+import https from 'https';
+import { Duplex } from 'stream';
+import { EventEmitter } from 'events';
+declare function createAgent(opts?: createAgent.AgentOptions): createAgent.Agent;
+declare function createAgent(callback: createAgent.AgentCallback, opts?: createAgent.AgentOptions): createAgent.Agent;
+declare namespace createAgent {
+    interface ClientRequest extends http.ClientRequest {
+        _last?: boolean;
+        _hadError?: boolean;
+        method: string;
+    }
+    interface AgentRequestOptions {
+        host?: string;
+        path?: string;
+        port: number;
+    }
+    interface HttpRequestOptions extends AgentRequestOptions, Omit<http.RequestOptions, keyof AgentRequestOptions> {
+        secureEndpoint: false;
+    }
+    interface HttpsRequestOptions extends AgentRequestOptions, Omit<https.RequestOptions, keyof AgentRequestOptions> {
+        secureEndpoint: true;
+    }
+    type RequestOptions = HttpRequestOptions | HttpsRequestOptions;
+    type AgentLike = Pick<createAgent.Agent, 'addRequest'> | http.Agent;
+    type AgentCallbackReturn = Duplex | AgentLike;
+    type AgentCallbackCallback = (err?: Error | null, socket?: createAgent.AgentCallbackReturn) => void;
+    type AgentCallbackPromise = (req: createAgent.ClientRequest, opts: createAgent.RequestOptions) => createAgent.AgentCallbackReturn | Promise<createAgent.AgentCallbackReturn>;
+    type AgentCallback = typeof Agent.prototype.callback;
+    type AgentOptions = {
+        timeout?: number;
+    };
+    /**
+     * Base `http.Agent` implementation.
+     * No pooling/keep-alive is implemented by default.
+     *
+     * @param {Function} callback
+     * @api public
+     */
+    class Agent extends EventEmitter {
+        timeout: number | null;
+        maxFreeSockets: number;
+        maxTotalSockets: number;
+        maxSockets: number;
+        sockets: {
+            [key: string]: net.Socket[];
+        };
+        freeSockets: {
+            [key: string]: net.Socket[];
+        };
+        requests: {
+            [key: string]: http.IncomingMessage[];
+        };
+        options: https.AgentOptions;
+        private promisifiedCallback?;
+        private explicitDefaultPort?;
+        private explicitProtocol?;
+        constructor(callback?: createAgent.AgentCallback | createAgent.AgentOptions, _opts?: createAgent.AgentOptions);
+        get defaultPort(): number;
+        set defaultPort(v: number);
+        get protocol(): string;
+        set protocol(v: string);
+        callback(req: createAgent.ClientRequest, opts: createAgent.RequestOptions, fn: createAgent.AgentCallbackCallback): void;
+        callback(req: createAgent.ClientRequest, opts: createAgent.RequestOptions): createAgent.AgentCallbackReturn | Promise<createAgent.AgentCallbackReturn>;
+        /**
+         * Called by node-core's "_http_client.js" module when creating
+         * a new HTTP request with this Agent instance.
+         *
+         * @api public
+         */
+        addRequest(req: ClientRequest, _opts: RequestOptions): void;
+        freeSocket(socket: net.Socket, opts: AgentOptions): void;
+        destroy(): void;
+    }
+}
+export = createAgent;