@dudousxd/nestjs-agent 1.5.0 → 1.7.0

package/README.md

@@ -130,6 +130,55 @@ nobody is streaming (including one that has already finished). In-process caller
 authorized elsewhere use `AgentService.subscribe(runId)`; anything reachable from a request must go
 through `AgentService.subscribeAs(actor, runId)`.
 
+### Resuming a dropped stream
+
+Every event frame of `POST /agent/chat` and `GET /agent/chat/:runId/stream` carries an SSE `id:` —
+its 1-based position in the run, the same on every attach. `GET …/stream?after=<n>` (or the
+`Last-Event-ID` header) skips what a reconnecting client already has; the React transport uses it to
+continue a message after a network drop. See docs/stream-protocol.md.
+
+### Message feedback
+
+`POST /agent/messages/:id/feedback` `{ value: 'up' | 'down' | null, comment? }` rates a message in
+one of the caller's threads (`null` clears it) and answers `{ feedback }`; `GET /agent/threads/:id`
+returns it on the message. It needs a store with `threadOfMessage` + `setMessageFeedback` (both
+bundled stores and `InMemoryAgentStore` have them) — `501` otherwise.
+
+### Letting callers pick a model
+
+```ts
+AgentModule.forRoot({
+  model: aiSdkModel('openai/gpt-4o-mini', { resolveModel: (id) => gateway(id) }),
+  models: {
+    list: ({ actor }) => ({
+      default: 'openai/gpt-4o-mini',
+      providers: [
+        {
+          id: 'openai',
+          label: 'OpenAI',
+          models: [
+            { id: 'openai/gpt-4o-mini', label: 'GPT-4o mini', badges: ['fast'], available: true },
+            {
+              id: 'openai/o3',
+              label: 'o3',
+              badges: ['reasoning'],
+              available: actor.roles?.includes('PRO') === true,
+              unavailableReason: 'Pro plan',
+            },
+          ],
+        },
+      ],
+    }),
+  },
+});
+```
+
+`GET /agent/models?agent=` answers the catalog for the caller (empty without one). A turn runs on
+the send's `model`, else the thread's pinned one (`PATCH /agent/threads/:id { model }`), else the
+provider's default; the id reaches the provider as `ModelTurnArgs.model` for every call of the turn.
+A model the catalog does not list as available for that actor and agent is refused with `400` —
+when pinned and again on each turn. `staticModelCatalog(view)` wraps a fixed list.
+
 ### Who approves an action, and for how long
 
 Every `action` tool call waits on the person chatting by default. `approvalPolicy` changes that per

package/dist/{agent-deps.factory-CUyVPsa1.d.cts → agent-deps.factory-CiC5Va9J.d.cts}

@@ -1,4 +1,4 @@
-import { ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry } from '@dudousxd/nestjs-agent-core';
+import { ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, ModelCatalog, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry } from '@dudousxd/nestjs-agent-core';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Provider, FactoryProvider, Type, CanActivate, ModuleMetadata, InjectionToken, OptionalFactoryDependency } from '@nestjs/common';
 
@@ -199,6 +199,12 @@ interface AgentModuleOptions {
      * `quotaLimitTokens` instead, which binds the built-in ledger-backed store.
      */
     quota?: QuotaStore;
+    /**
+     * Which models a caller may pick — `GET <base>/models`, a send's `model`, a thread's pinned model
+     * (`PATCH <base>/threads/:id { model }`). The picked id reaches the {@link ModelProvider} as
+     * `ModelTurnArgs.model`. Omit → an empty catalog, and a request naming a model is refused.
+     */
+    models?: ModelCatalog;
     /**
      * Daily per-actor token budget, enforced against the persisted usage ledger by the built-in
      * `LedgerQuotaStore`. A convenience over wiring a {@link QuotaStore} by hand — set this and quotas

package/dist/{agent-deps.factory-CUyVPsa1.d.ts → agent-deps.factory-CiC5Va9J.d.ts}

@@ -1,4 +1,4 @@
-import { ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry } from '@dudousxd/nestjs-agent-core';
+import { ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, ModelCatalog, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry } from '@dudousxd/nestjs-agent-core';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Provider, FactoryProvider, Type, CanActivate, ModuleMetadata, InjectionToken, OptionalFactoryDependency } from '@nestjs/common';
 
@@ -199,6 +199,12 @@ interface AgentModuleOptions {
      * `quotaLimitTokens` instead, which binds the built-in ledger-backed store.
      */
     quota?: QuotaStore;
+    /**
+     * Which models a caller may pick — `GET <base>/models`, a send's `model`, a thread's pinned model
+     * (`PATCH <base>/threads/:id { model }`). The picked id reaches the {@link ModelProvider} as
+     * `ModelTurnArgs.model`. Omit → an empty catalog, and a request naming a model is refused.
+     */
+    models?: ModelCatalog;
     /**
      * Daily per-actor token budget, enforced against the persisted usage ledger by the built-in
      * `LedgerQuotaStore`. A convenience over wiring a {@link QuotaStore} by hand — set this and quotas