@exposify/express 0.3.7 → 0.3.9

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { RouteInfo, AgentReadyOptions } from '@exposify/core';
-export { describe, exposed, hidden } from '@exposify/core';
+export { HostedAuthResolverConfig, completeMcpLogin, createHostedAuthResolver, describe, exposed, hidden, hostedBroker } from '@exposify/core';
 
 interface RoutesFromExpressOptions {
     /**
@@ -15,7 +15,22 @@ interface RoutesFromExpressOptions {
 }
 declare function routesFromExpress(app: unknown, opts?: RoutesFromExpressOptions): RouteInfo[];
 
+/** Symbol under which `aiReady()`'s middleware carries the options it was given. */
+declare const AIREADY_OPTIONS_TAG: unique symbol;
+
 interface ExpressAiReadyOptions extends AgentReadyOptions {
+    /**
+     * The app's own login, for Connect with the hosted broker: AI assistants
+     * sign in on a form served at /mcp/login, which makes this login request
+     * through your app. Found by itself (a POST route that reads a password
+     * from the body and sets a session or signs a token); name another route
+     * (`{ path, fields }`), or `false` to not offer it.
+     */
+    login?: false | {
+        path: string;
+        fields: string[];
+        body?: "json" | "form";
+    };
     /** Where docs globs and the .exposify cache resolve. Default: process.cwd() */
     cwd?: string;
     /**
@@ -29,7 +44,20 @@ interface ExpressAiReadyOptions extends AgentReadyOptions {
      * router/app object registered at that prefix.
      */
     mounts?: Record<string, unknown>;
+    /**
+     * Tool descriptions file written by `exposify-express setup`/`describe`.
+     * Default: exposify.descriptions.json in `cwd`, if present. `false` ignores it.
+     * describe() text in code still wins over it.
+     */
+    descriptions?: string | false;
+    /**
+     * The app's OpenAPI document: an object (e.g. `SwaggerModule.createDocument(app, …)`
+     * in NestJS) or a path to a JSON file. Matching operations give tools real
+     * input schemas, and their summary/description becomes the tool description
+     * (below describe() and exposify.descriptions.json).
+     */
+    openapi?: string | object;
 }
 declare function aiReady(options?: ExpressAiReadyOptions): (req: any, res: any, next: any) => void;
 
-export { type ExpressAiReadyOptions, aiReady, routesFromExpress };
+export { AIREADY_OPTIONS_TAG, type ExpressAiReadyOptions, aiReady, routesFromExpress };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { RouteInfo, AgentReadyOptions } from '@exposify/core';
-export { describe, exposed, hidden } from '@exposify/core';
+export { HostedAuthResolverConfig, completeMcpLogin, createHostedAuthResolver, describe, exposed, hidden, hostedBroker } from '@exposify/core';
 
 interface RoutesFromExpressOptions {
     /**
@@ -15,7 +15,22 @@ interface RoutesFromExpressOptions {
 }
 declare function routesFromExpress(app: unknown, opts?: RoutesFromExpressOptions): RouteInfo[];
 
+/** Symbol under which `aiReady()`'s middleware carries the options it was given. */
+declare const AIREADY_OPTIONS_TAG: unique symbol;
+
 interface ExpressAiReadyOptions extends AgentReadyOptions {
+    /**
+     * The app's own login, for Connect with the hosted broker: AI assistants
+     * sign in on a form served at /mcp/login, which makes this login request
+     * through your app. Found by itself (a POST route that reads a password
+     * from the body and sets a session or signs a token); name another route
+     * (`{ path, fields }`), or `false` to not offer it.
+     */
+    login?: false | {
+        path: string;
+        fields: string[];
+        body?: "json" | "form";
+    };
     /** Where docs globs and the .exposify cache resolve. Default: process.cwd() */
     cwd?: string;
     /**
@@ -29,7 +44,20 @@ interface ExpressAiReadyOptions extends AgentReadyOptions {
      * router/app object registered at that prefix.
      */
     mounts?: Record<string, unknown>;
+    /**
+     * Tool descriptions file written by `exposify-express setup`/`describe`.
+     * Default: exposify.descriptions.json in `cwd`, if present. `false` ignores it.
+     * describe() text in code still wins over it.
+     */
+    descriptions?: string | false;
+    /**
+     * The app's OpenAPI document: an object (e.g. `SwaggerModule.createDocument(app, …)`
+     * in NestJS) or a path to a JSON file. Matching operations give tools real
+     * input schemas, and their summary/description becomes the tool description
+     * (below describe() and exposify.descriptions.json).
+     */
+    openapi?: string | object;
 }
 declare function aiReady(options?: ExpressAiReadyOptions): (req: any, res: any, next: any) => void;
 
-export { type ExpressAiReadyOptions, aiReady, routesFromExpress };
+export { AIREADY_OPTIONS_TAG, type ExpressAiReadyOptions, aiReady, routesFromExpress };