@microsoft/agents-hosting-express 1.7.0-beta.1.g8bcd4f11a7 → 1.7.1

package/README.md

@@ -69,6 +69,8 @@ app.listen(3978);
 
 For full control, use `createCloudAdapter` to obtain the `CloudAdapter` directly. This is useful when you need to customize request processing and can provide the request/response shape expected by `CloudAdapter.process`.
 
+> `createCloudAdapter` is now exported from `@microsoft/agents-hosting`; the re-export below is preserved for backward compatibility. New code may import it directly from `@microsoft/agents-hosting` to avoid taking a dependency on Express.
+
 `CloudAdapter.process` expects:
 
 - a parsed activity body on `req.body` (for example, via `express.json()` in Express)

package/dist/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package.json",
     "name": "@microsoft/agents-hosting-express",
-    "version": "1.7.0-beta.1.g8bcd4f11a7",
+    "version": "1.7.1",
     "homepage": "https://github.com/microsoft/Agents-for-js",
     "repository": {
         "type": "git",
@@ -19,8 +19,8 @@
     "main": "dist/src/index.js",
     "types": "dist/src/index.d.ts",
     "dependencies": {
-        "@microsoft/agents-hosting": "1.7.0-beta.1.g8bcd4f11a7",
-        "@microsoft/agents-telemetry": "1.7.0-beta.1.g8bcd4f11a7",
+        "@microsoft/agents-hosting": "1.7.1",
+        "@microsoft/agents-telemetry": "1.7.1",
         "express": "5.2.1",
         "express-rate-limit": "8.5.2"
     },

package/dist/src/createAgentRequestHandler.d.ts

@@ -2,19 +2,12 @@
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the MIT License.
  */
-import { ActivityHandler, AgentApplication, AuthConfiguration, Request, TurnState } from '@microsoft/agents-hosting';
+import { ActivityHandler, AgentApplication, AuthConfiguration, WebResponse, Request, TurnState } from '@microsoft/agents-hosting';
 /**
- * Minimal response interface describing the methods used by the Agent request handler.
- * Any framework whose response object satisfies this shape is compatible.
+ * Re-export of `WebResponse` from `@microsoft/agents-hosting` for backward compatibility.
+ * New code should import `WebResponse` directly from `@microsoft/agents-hosting`.
  */
-export interface WebResponse {
-    status(code: number): this;
-    setHeader(name: string, value: string): this;
-    send(body?: unknown): this;
-    end(): this;
-    headersSent: boolean;
-    writableEnded: boolean;
-}
+export type { WebResponse };
 /**
  * A request handler function signature that does not import Express types in its public API.
  *

package/dist/src/createAgentRequestHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"createAgentRequestHandler.js","sourceRoot":"","sources":["../../src/createAgentRequestHandler.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,8DAA6J;AAC7J,6DAAyD;AAwBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACI,MAAM,yBAAyB,GAAG,CACvC,KAA8D,EAC9D,iBAAqC,EAChB,EAAE;IACvB,MAAM,UAAU,GAAG,IAAA,0CAAyB,EAAC,iBAAiB,CAAC,CAAA;IAC/D,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAA,uCAAkB,EAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IAC5E,MAAM,aAAa,GAAG,IAAA,6BAAY,EAAC,UAAU,CAAC,CAAA;IAE9C,OAAO,KAAK,EAAE,GAAY,EAAE,GAAgB,EAAiB,EAAE;QAC7D,IAAI,eAAoB,CAAA;QACxB,IAAI,UAAU,GAAG,KAAK,CAAA;QAEtB,MAAM,aAAa,CAAC,GAAG,EAAE,GAAe,EAAE,CAAC,GAAS,EAAE,EAAE;YACtD,UAAU,GAAG,IAAI,CAAA;YACjB,eAAe,GAAG,GAAG,CAAA;QACvB,CAAC,CAAC,CAAA;QAEF,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,eAAe,CAAA;QACvB,CAAC;QAED,uGAAuG;QACvG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACnC,OAAM;QACR,CAAC;QAED,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAA;IACjG,CAAC,CAAA;AACH,CAAC,CAAA;AA5BY,QAAA,yBAAyB,6BA4BrC"}
+{"version":3,"file":"createAgentRequestHandler.js","sourceRoot":"","sources":["../../src/createAgentRequestHandler.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,8DAA0K;AAC1K,6DAAyD;AA8BzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACI,MAAM,yBAAyB,GAAG,CACvC,KAA8D,EAC9D,iBAAqC,EAChB,EAAE;IACvB,MAAM,UAAU,GAAG,IAAA,0CAAyB,EAAC,iBAAiB,CAAC,CAAA;IAC/D,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAA,uCAAkB,EAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IAC5E,MAAM,aAAa,GAAG,IAAA,6BAAY,EAAC,UAAU,CAAC,CAAA;IAE9C,OAAO,KAAK,EAAE,GAAY,EAAE,GAAgB,EAAiB,EAAE;QAC7D,IAAI,eAAoB,CAAA;QACxB,IAAI,UAAU,GAAG,KAAK,CAAA;QAEtB,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAS,EAAE,EAAE;YAC1C,UAAU,GAAG,IAAI,CAAA;YACjB,eAAe,GAAG,GAAG,CAAA;QACvB,CAAC,CAAC,CAAA;QAEF,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,eAAe,CAAA;QACvB,CAAC;QAED,uGAAuG;QACvG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACnC,OAAM;QACR,CAAC;QAED,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAA;IACrF,CAAC,CAAA;AACH,CAAC,CAAA;AA5BY,QAAA,yBAAyB,6BA4BrC"}

package/dist/src/createCloudAdapter.d.ts

@@ -1,36 +1,9 @@
 /**
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the MIT License.
- */
-import { ActivityHandler, AgentApplication, AuthConfiguration, CloudAdapter, HeaderPropagationDefinition, TurnState } from '@microsoft/agents-hosting';
-/**
- * Result of creating a CloudAdapter from an agent.
- */
-export interface CloudAdapterResult {
-    adapter: CloudAdapter;
-    headerPropagation: HeaderPropagationDefinition | undefined;
-}
-/**
- * Creates a CloudAdapter for the given agent.
- *
- * If the agent is an AgentApplication with a pre-configured adapter, that adapter is reused.
- * Otherwise, a new CloudAdapter is created.
- *
- * @param agent - The AgentApplication or ActivityHandler instance.
- * @param authConfig - Optional auth configuration used when creating a new CloudAdapter.
- * If the agent already has an adapter, that adapter is reused and this value is ignored.
- * @returns An object containing the CloudAdapter and optional header propagation configuration.
- *
- * @example
- * ```typescript
- * import { AgentApplication, TurnState } from '@microsoft/agents-hosting';
- * import { createCloudAdapter } from '@microsoft/agents-hosting-express';
- *
- * const app = new AgentApplication<TurnState>();
- * const { adapter, headerPropagation } = createCloudAdapter(app, { clientId: process.env.CLIENT_ID });
  *
- * // Use the adapter directly with request/response objects compatible with CloudAdapter.process
- * adapter.process(req, res, (context) => app.run(context), headerPropagation);
- * ```
+ * Re-export from `@microsoft/agents-hosting` for backward compatibility.
+ * `createCloudAdapter` was moved into core so it can be reused by Fastify and
+ * other hosting integrations without dragging the Express runtime along.
  */
-export declare const createCloudAdapter: (agent: AgentApplication<TurnState<any, any>> | ActivityHandler, authConfig?: AuthConfiguration) => CloudAdapterResult;
+export { createCloudAdapter, type CloudAdapterResult } from '@microsoft/agents-hosting';

package/dist/src/createCloudAdapter.js

@@ -2,44 +2,13 @@
 /**
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the MIT License.
+ *
+ * Re-export from `@microsoft/agents-hosting` for backward compatibility.
+ * `createCloudAdapter` was moved into core so it can be reused by Fastify and
+ * other hosting integrations without dragging the Express runtime along.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCloudAdapter = void 0;
-const agents_hosting_1 = require("@microsoft/agents-hosting");
-/**
- * Creates a CloudAdapter for the given agent.
- *
- * If the agent is an AgentApplication with a pre-configured adapter, that adapter is reused.
- * Otherwise, a new CloudAdapter is created.
- *
- * @param agent - The AgentApplication or ActivityHandler instance.
- * @param authConfig - Optional auth configuration used when creating a new CloudAdapter.
- * If the agent already has an adapter, that adapter is reused and this value is ignored.
- * @returns An object containing the CloudAdapter and optional header propagation configuration.
- *
- * @example
- * ```typescript
- * import { AgentApplication, TurnState } from '@microsoft/agents-hosting';
- * import { createCloudAdapter } from '@microsoft/agents-hosting-express';
- *
- * const app = new AgentApplication<TurnState>();
- * const { adapter, headerPropagation } = createCloudAdapter(app, { clientId: process.env.CLIENT_ID });
- *
- * // Use the adapter directly with request/response objects compatible with CloudAdapter.process
- * adapter.process(req, res, (context) => app.run(context), headerPropagation);
- * ```
- */
-const createCloudAdapter = (agent, authConfig) => {
-    let adapter;
-    let headerPropagation;
-    if (agent instanceof agents_hosting_1.ActivityHandler || !agent.adapter) {
-        adapter = new agents_hosting_1.CloudAdapter(authConfig);
-    }
-    else {
-        adapter = agent.adapter;
-        headerPropagation = agent === null || agent === void 0 ? void 0 : agent.options.headerPropagation;
-    }
-    return { adapter, headerPropagation };
-};
-exports.createCloudAdapter = createCloudAdapter;
+var agents_hosting_1 = require("@microsoft/agents-hosting");
+Object.defineProperty(exports, "createCloudAdapter", { enumerable: true, get: function () { return agents_hosting_1.createCloudAdapter; } });
 //# sourceMappingURL=createCloudAdapter.js.map

package/dist/src/createCloudAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCloudAdapter.js","sourceRoot":"","sources":["../../src/createCloudAdapter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,8DAAsJ;AAUtJ;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,MAAM,kBAAkB,GAAG,CAChC,KAA8D,EAC9D,UAA8B,EACV,EAAE;IACtB,IAAI,OAAqB,CAAA;IACzB,IAAI,iBAA0D,CAAA;IAC9D,IAAI,KAAK,YAAY,gCAAe,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACvD,OAAO,GAAG,IAAI,6BAAY,CAAC,UAAU,CAAC,CAAA;IACxC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,KAAK,CAAC,OAAuB,CAAA;QACvC,iBAAiB,GAAI,KAA+C,aAA/C,KAAK,uBAAL,KAAK,CAA4C,OAAO,CAAC,iBAAiB,CAAA;IACjG,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;AACvC,CAAC,CAAA;AAbY,QAAA,kBAAkB,sBAa9B"}
+{"version":3,"file":"createCloudAdapter.js","sourceRoot":"","sources":["../../src/createCloudAdapter.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,4DAAuF;AAA9E,oHAAA,kBAAkB,OAAA"}

package/dist/src/startServer.js

@@ -19,7 +19,12 @@ function startServer(agent, optionsOrAuth) {
     var _a, _b, _c;
     const isOptions = typeof optionsOrAuth === 'object' && optionsOrAuth !== null &&
         ('authConfig' in optionsOrAuth || 'port' in optionsOrAuth || 'routePath' in optionsOrAuth || 'rateLimitOptions' in optionsOrAuth || 'beforeListen' in optionsOrAuth);
-    const opts = isOptions ? optionsOrAuth : { authConfig: optionsOrAuth };
+    // Legacy overload: the second argument is a raw AuthConfiguration. An empty object carries no auth
+    // settings, so treat it like no argument and load defaults from the environment (matching startServer(agent)).
+    const hasAuthSettings = !isOptions && optionsOrAuth != null && Object.keys(optionsOrAuth).length > 0;
+    const opts = isOptions
+        ? optionsOrAuth
+        : { authConfig: hasAuthSettings ? optionsOrAuth : undefined };
     const authConfig = (0, agents_hosting_1.getAuthConfigWithDefaults)(opts.authConfig);
     const routePath = (_a = opts.routePath) !== null && _a !== void 0 ? _a : '/api/messages';
     const { adapter, headerPropagation } = (0, createCloudAdapter_1.createCloudAdapter)(agent, authConfig);

package/dist/src/startServer.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@microsoft/agents-hosting-express",
-  "version": "1.7.0-beta.1.g8bcd4f11a7",
+  "version": "1.7.1",
   "homepage": "https://github.com/microsoft/Agents-for-js",
   "repository": {
     "type": "git",
@@ -19,8 +19,8 @@
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
   "dependencies": {
-    "@microsoft/agents-hosting": "1.7.0-beta.1.g8bcd4f11a7",
-    "@microsoft/agents-telemetry": "1.7.0-beta.1.g8bcd4f11a7",
+    "@microsoft/agents-hosting": "1.7.1",
+    "@microsoft/agents-telemetry": "1.7.1",
     "express": "5.2.1",
     "express-rate-limit": "8.5.2"
   },

package/src/createAgentRequestHandler.ts

@@ -3,22 +3,28 @@
  * Licensed under the MIT License.
  */
 
-import { type Response } from 'express'
-import { ActivityHandler, AgentApplication, AuthConfiguration, authorizeJWT, getAuthConfigWithDefaults, Request, TurnState } from '@microsoft/agents-hosting'
+import { type Response as ExpressResponse } from 'express'
+import { ActivityHandler, AgentApplication, AuthConfiguration, authorizeJWT, getAuthConfigWithDefaults, WebResponse, Request, TurnState } from '@microsoft/agents-hosting'
 import { createCloudAdapter } from './createCloudAdapter'
 
 /**
- * Minimal response interface describing the methods used by the Agent request handler.
- * Any framework whose response object satisfies this shape is compatible.
+ * Compile-time contract guard — no runtime effect; type-checked by `npm run build`.
+ *
+ * Locks in the structural relationship the Express integration relies on: Express's
+ * `Response` must remain assignable to `WebResponse` (the response parameter of
+ * `CloudAdapter.process` and `authorizeJWT`). If `WebResponse` ever drifts — e.g. it
+ * gains a member that Express's `Response` does not provide — this line fails to
+ * compile, surfacing the break here at build time rather than in consumer code.
  */
-export interface WebResponse {
-  status (code: number): this
-  setHeader (name: string, value: string): this
-  send (body?: unknown): this
-  end (): this
-  headersSent: boolean
-  writableEnded: boolean
-}
+type AssertAssignable<Target, Source extends Target> = Source
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+type _ExpressResponseSatisfiesWebResponse = AssertAssignable<WebResponse, ExpressResponse>
+
+/**
+ * Re-export of `WebResponse` from `@microsoft/agents-hosting` for backward compatibility.
+ * New code should import `WebResponse` directly from `@microsoft/agents-hosting`.
+ */
+export type { WebResponse }
 
 /**
  * A request handler function signature that does not import Express types in its public API.
@@ -72,7 +78,7 @@ export const createAgentRequestHandler = (
     let middlewareError: any
     let nextCalled = false
 
-    await jwtMiddleware(req, res as Response, (err?: any) => {
+    await jwtMiddleware(req, res, (err?: any) => {
       nextCalled = true
       middlewareError = err
     })
@@ -86,6 +92,6 @@ export const createAgentRequestHandler = (
       return
     }
 
-    await adapter.process(req, res as Response, (context) => agent.run(context), headerPropagation)
+    await adapter.process(req, res, (context) => agent.run(context), headerPropagation)
   }
 }

package/src/createCloudAdapter.ts

@@ -1,52 +1,10 @@
 /**
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the MIT License.
- */
-
-import { ActivityHandler, AgentApplication, AuthConfiguration, CloudAdapter, HeaderPropagationDefinition, TurnState } from '@microsoft/agents-hosting'
-
-/**
- * Result of creating a CloudAdapter from an agent.
- */
-export interface CloudAdapterResult {
-  adapter: CloudAdapter
-  headerPropagation: HeaderPropagationDefinition | undefined
-}
-
-/**
- * Creates a CloudAdapter for the given agent.
- *
- * If the agent is an AgentApplication with a pre-configured adapter, that adapter is reused.
- * Otherwise, a new CloudAdapter is created.
- *
- * @param agent - The AgentApplication or ActivityHandler instance.
- * @param authConfig - Optional auth configuration used when creating a new CloudAdapter.
- * If the agent already has an adapter, that adapter is reused and this value is ignored.
- * @returns An object containing the CloudAdapter and optional header propagation configuration.
  *
- * @example
- * ```typescript
- * import { AgentApplication, TurnState } from '@microsoft/agents-hosting';
- * import { createCloudAdapter } from '@microsoft/agents-hosting-express';
- *
- * const app = new AgentApplication<TurnState>();
- * const { adapter, headerPropagation } = createCloudAdapter(app, { clientId: process.env.CLIENT_ID });
- *
- * // Use the adapter directly with request/response objects compatible with CloudAdapter.process
- * adapter.process(req, res, (context) => app.run(context), headerPropagation);
- * ```
+ * Re-export from `@microsoft/agents-hosting` for backward compatibility.
+ * `createCloudAdapter` was moved into core so it can be reused by Fastify and
+ * other hosting integrations without dragging the Express runtime along.
  */
-export const createCloudAdapter = (
-  agent: AgentApplication<TurnState<any, any>> | ActivityHandler,
-  authConfig?: AuthConfiguration
-): CloudAdapterResult => {
-  let adapter: CloudAdapter
-  let headerPropagation: HeaderPropagationDefinition | undefined
-  if (agent instanceof ActivityHandler || !agent.adapter) {
-    adapter = new CloudAdapter(authConfig)
-  } else {
-    adapter = agent.adapter as CloudAdapter
-    headerPropagation = (agent as AgentApplication<TurnState<any, any>>)?.options.headerPropagation
-  }
-  return { adapter, headerPropagation }
-}
+
+export { createCloudAdapter, type CloudAdapterResult } from '@microsoft/agents-hosting'

package/src/startServer.ts

@@ -113,7 +113,12 @@ export function startServer (agent: AgentApplication<TurnState<any, any>> | Acti
   const isOptions = typeof optionsOrAuth === 'object' && optionsOrAuth !== null &&
     ('authConfig' in optionsOrAuth || 'port' in optionsOrAuth || 'routePath' in optionsOrAuth || 'rateLimitOptions' in optionsOrAuth || 'beforeListen' in optionsOrAuth)
 
-  const opts: StartServerOptions = isOptions ? optionsOrAuth as StartServerOptions : { authConfig: optionsOrAuth as AuthConfiguration | undefined }
+  // Legacy overload: the second argument is a raw AuthConfiguration. An empty object carries no auth
+  // settings, so treat it like no argument and load defaults from the environment (matching startServer(agent)).
+  const hasAuthSettings = !isOptions && optionsOrAuth != null && Object.keys(optionsOrAuth).length > 0
+  const opts: StartServerOptions = isOptions
+    ? optionsOrAuth as StartServerOptions
+    : { authConfig: hasAuthSettings ? optionsOrAuth as AuthConfiguration : undefined }
   const authConfig: AuthConfiguration = getAuthConfigWithDefaults(opts.authConfig)
   const routePath = opts.routePath ?? '/api/messages'
   const { adapter, headerPropagation } = createCloudAdapter(agent, authConfig)