@dudousxd/nestjs-agent 1.17.0 → 1.18.0

package/dist/{chat-queue.service-Bqq00NN1.d.cts → chat-queue.service-5LIogd9K.d.cts}

@@ -130,6 +130,24 @@ declare class LedgerQuotaProvider implements QuotaProvider {
     private window;
 }
 
+/**
+ * A wire protocol other than the native one, served over the same runs — what `adapters` on
+ * `AgentModule.forRoot` takes. An adapter contributes controllers, mounted under the agent's
+ * `path` and guarded by its `guards` exactly like the native routes; the runs, the store, the
+ * approvals and the quota are the library's, unchanged.
+ *
+ * `agUiAdapter()` is the one that ships. Write your own the same way: a controller that injects
+ * `AgentService` (and `AGENT_ACTOR_RESOLVER`) and translates.
+ */
+interface AgentProtocolAdapter {
+    /** For logs and diagnostics. */
+    name: string;
+    /** Mounted under the agent's path. Not mounted at all on `surface: 'engine'`. */
+    controllers: Type<object>[];
+    /** Extra providers the controllers inject. */
+    providers?: Provider[];
+}
+
 /**
  * Which half of the module this process mounts — the split that lets an API pod and a WORKER pod
  * each load `AgentModule` without either one doing the other's job:
@@ -432,6 +450,12 @@ interface AgentModuleOptions {
      * which controllers exist at module-build time, not something a request can flip.
      */
     surface?: AgentSurface;
+    /**
+     * Wire protocols served alongside the native one, over the same runs — e.g. `[agUiAdapter()]`
+     * mounts `POST <path>/ag-ui` (AG-UI 1.0). Their controllers mount under `path`, behind `guards`,
+     * and not at all on `surface: 'engine'`. STATIC, like `surface`.
+     */
+    adapters?: AgentProtocolAdapter[];
 }
 interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
     inject?: Array<InjectionToken | OptionalFactoryDependency>;
@@ -462,6 +486,8 @@ interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
      * which controllers exist. Omit → `'both'`, today's behavior with zero change.
      */
     surface?: AgentSurface;
+    /** Wire protocols served alongside the native one — see `AgentModuleOptions.adapters`. STATIC. */
+    adapters?: AgentProtocolAdapter[];
 }
 
 /**
@@ -642,4 +668,4 @@ declare class ChatQueueService {
     private freshAttachments;
 }
 
-export { AgentDepsFactory as A, ChatQueueService as C, type FunctionalTool as F, LedgerQuotaProvider as L, type QueuePlan as Q, type AgentSurface as a, type AgentModuleOptions as b, type AgentModuleAsyncOptions as c, type AgentSkillsOptions as d, AGENT_TOOL_BRAND as e, type AgentAttachmentsOptions as f, type AgentDeps as g, type AgentMemoryOptions as h, type QueueSettleOutcome as i, type QueuedTurn as j, type QueuedTurnStarter as k, type QuotaLimits as l, type QuotaWindowLimits as m, delegateToolName as n, provideAgentTools as o, provideAgentTool as p, utcDay as u };
+export { AgentDepsFactory as A, ChatQueueService as C, type FunctionalTool as F, LedgerQuotaProvider as L, type QueuePlan as Q, type AgentSurface as a, type AgentModuleOptions as b, type AgentModuleAsyncOptions as c, type AgentProtocolAdapter as d, type AgentSkillsOptions as e, AGENT_TOOL_BRAND as f, type AgentAttachmentsOptions as g, type AgentDeps as h, type AgentMemoryOptions as i, type QueueSettleOutcome as j, type QueuedTurn as k, type QueuedTurnStarter as l, type QuotaLimits as m, type QuotaWindowLimits as n, delegateToolName as o, provideAgentTool as p, provideAgentTools as q, utcDay as u };

package/dist/{chat-queue.service-Bqq00NN1.d.ts → chat-queue.service-5LIogd9K.d.ts}

@@ -130,6 +130,24 @@ declare class LedgerQuotaProvider implements QuotaProvider {
     private window;
 }
 
+/**
+ * A wire protocol other than the native one, served over the same runs — what `adapters` on
+ * `AgentModule.forRoot` takes. An adapter contributes controllers, mounted under the agent's
+ * `path` and guarded by its `guards` exactly like the native routes; the runs, the store, the
+ * approvals and the quota are the library's, unchanged.
+ *
+ * `agUiAdapter()` is the one that ships. Write your own the same way: a controller that injects
+ * `AgentService` (and `AGENT_ACTOR_RESOLVER`) and translates.
+ */
+interface AgentProtocolAdapter {
+    /** For logs and diagnostics. */
+    name: string;
+    /** Mounted under the agent's path. Not mounted at all on `surface: 'engine'`. */
+    controllers: Type<object>[];
+    /** Extra providers the controllers inject. */
+    providers?: Provider[];
+}
+
 /**
  * Which half of the module this process mounts — the split that lets an API pod and a WORKER pod
  * each load `AgentModule` without either one doing the other's job:
@@ -432,6 +450,12 @@ interface AgentModuleOptions {
      * which controllers exist at module-build time, not something a request can flip.
      */
     surface?: AgentSurface;
+    /**
+     * Wire protocols served alongside the native one, over the same runs — e.g. `[agUiAdapter()]`
+     * mounts `POST <path>/ag-ui` (AG-UI 1.0). Their controllers mount under `path`, behind `guards`,
+     * and not at all on `surface: 'engine'`. STATIC, like `surface`.
+     */
+    adapters?: AgentProtocolAdapter[];
 }
 interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
     inject?: Array<InjectionToken | OptionalFactoryDependency>;
@@ -462,6 +486,8 @@ interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
      * which controllers exist. Omit → `'both'`, today's behavior with zero change.
      */
     surface?: AgentSurface;
+    /** Wire protocols served alongside the native one — see `AgentModuleOptions.adapters`. STATIC. */
+    adapters?: AgentProtocolAdapter[];
 }
 
 /**
@@ -642,4 +668,4 @@ declare class ChatQueueService {
     private freshAttachments;
 }
 
-export { AgentDepsFactory as A, ChatQueueService as C, type FunctionalTool as F, LedgerQuotaProvider as L, type QueuePlan as Q, type AgentSurface as a, type AgentModuleOptions as b, type AgentModuleAsyncOptions as c, type AgentSkillsOptions as d, AGENT_TOOL_BRAND as e, type AgentAttachmentsOptions as f, type AgentDeps as g, type AgentMemoryOptions as h, type QueueSettleOutcome as i, type QueuedTurn as j, type QueuedTurnStarter as k, type QuotaLimits as l, type QuotaWindowLimits as m, delegateToolName as n, provideAgentTools as o, provideAgentTool as p, utcDay as u };
+export { AgentDepsFactory as A, ChatQueueService as C, type FunctionalTool as F, LedgerQuotaProvider as L, type QueuePlan as Q, type AgentSurface as a, type AgentModuleOptions as b, type AgentModuleAsyncOptions as c, type AgentProtocolAdapter as d, type AgentSkillsOptions as e, AGENT_TOOL_BRAND as f, type AgentAttachmentsOptions as g, type AgentDeps as h, type AgentMemoryOptions as i, type QueueSettleOutcome as j, type QueuedTurn as k, type QueuedTurnStarter as l, type QuotaLimits as m, type QuotaWindowLimits as n, delegateToolName as o, provideAgentTool as p, provideAgentTools as q, utcDay as u };