@dudousxd/nestjs-agent 0.1.0 → 0.3.0

package/dist/{agent-deps.factory-D9BHJJqm.d.cts → agent-deps.factory-DpVkZYCy.d.cts}

@@ -1,4 +1,4 @@
-import { ModelProvider, AgentStore, ToolRegistry, RolesPolicy, QuotaStore, TokenStreamSink, PromptBuilder, Persona, Retriever, ToolSpec, ToolHandler, ActorResolver, AgentDefinition, AgentRegistry } from '@dudousxd/nestjs-agent-core';
+import { ModelProvider, AgentStore, ToolRegistry, RolesPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Retriever, ToolSpec, ToolHandler, ActorResolver, AgentRegistry } from '@dudousxd/nestjs-agent-core';
 import { Provider, FactoryProvider, ModuleMetadata, InjectionToken, OptionalFactoryDependency } from '@nestjs/common';
 
 /** Everything `runAgentLoop` needs, minus the per-run `day` the runner stamps. */
@@ -12,10 +12,10 @@ interface AgentDeps {
     /** Fallback accounting label; the provider's turn result overrides it when set. */
     modelId?: string;
     systemPrompt: string | PromptBuilder;
+    /** App-wide `@SystemPromptContributor()` sections appended after the agent's base prompt. */
+    promptContributors: PromptContributor[];
     maxSteps: number;
-    personas: Map<string, Persona>;
-    defaultPersona: string;
-    /** Agent-level tool allow-list (intersected with the persona's). Undefined → all tools. */
+    /** Agent-level tool allow-list. Undefined → all tools (after role filtering). */
     toolAllowList?: string[];
     /** Per-tool execution timeout in ms (from module options). Undefined → no timeout. */
     toolTimeoutMs?: number;
@@ -49,15 +49,6 @@ interface FunctionalTool {
 declare function provideAgentTool(tool: FunctionalTool): Provider;
 declare function provideAgentTool(factory: (...deps: never[]) => FunctionalTool, inject?: FactoryProvider['inject']): Provider;
 
-/**
- * The implicit default agent, configured inline on `forRoot`. It is an {@link AgentDefinition}
- * with `name` optional (defaults to `'default'`) — everything agent-shaped is an AgentDefinition,
- * whether it's this default or one registered via `forFeature`. Omit it entirely for a bare
- * assistant with no base prompt, personas, or tool allow-list.
- */
-type DefaultAgentOptions = Omit<AgentDefinition, 'name'> & {
-    name?: string;
-};
 interface AgentModuleOptions {
     /** The LLM provider (e.g. a Vercel AI SDK wrapper). Required. */
     model: ModelProvider;
@@ -129,10 +120,11 @@ interface AgentModuleOptions {
         topK?: number;
     };
     /**
-     * The implicit single agent's config (base prompt, personas, tool allow-list, model/step
-     * config). Omit for a bare assistant. Additional named agents are added via `forFeature`.
+     * The name of the agent a turn uses when the caller doesn't select one. Omit → the single
+     * discovered `@Agent` (when there is exactly one), else `'default'` (a bare assistant if no
+     * `@Agent` is registered). Agents themselves are declared as `@Agent`-decorated providers, not here.
      */
-    defaultAgent?: DefaultAgentOptions;
+    defaultAgent?: string;
 }
 interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
     inject?: Array<InjectionToken | OptionalFactoryDependency>;
@@ -150,9 +142,9 @@ interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
     durable?: boolean;
 }
 
-/** The synthesized `agent`-kind tool name an orchestrator uses to delegate to `target`. */
+/** The synthesized `agent`-kind tool name an orchestrator uses to hand off to `target`. */
 declare function delegateToolName(target: string): string;
-/** Builds the per-agent loop deps. The single-agent case is just the `default` definition. */
+/** Builds the per-agent loop deps. The single-agent case is just the one registered `@Agent`. */
 declare class AgentDepsFactory {
     private readonly options;
     private readonly model;
@@ -161,8 +153,13 @@ declare class AgentDepsFactory {
     private readonly rolesPolicy;
     private readonly registry;
     private readonly agents;
+    private readonly promptContributors;
     private readonly quota;
-    constructor(options: AgentModuleOptions, model: ModelProvider, store: AgentStore, sink: TokenStreamSink, rolesPolicy: RolesPolicy, registry: ToolRegistry, agents: AgentRegistry, quota: QuotaStore | undefined);
+    constructor(options: AgentModuleOptions, model: ModelProvider, store: AgentStore, sink: TokenStreamSink, rolesPolicy: RolesPolicy, registry: ToolRegistry, agents: AgentRegistry, promptContributors: PromptContributor[], quota: QuotaStore | undefined);
+    /**
+     * The agent a turn uses when the caller names none: the explicit `defaultAgent` option, else the
+     * sole registered `@Agent` when there is exactly one, else `'default'` (a bare assistant).
+     */
     defaultAgentName(): string;
     private effectiveTools;
     forAgent(agentName?: string): AgentDeps;
@@ -170,4 +167,4 @@ declare class AgentDepsFactory {
     private followUpsCount;
 }
 
-export { AgentDepsFactory as A, type DefaultAgentOptions as D, type FunctionalTool as F, type AgentModuleOptions as a, type AgentModuleAsyncOptions as b, AGENT_TOOL_BRAND as c, type AgentDeps as d, delegateToolName as e, provideAgentTool as p, utcDay as u };
+export { AgentDepsFactory as A, type FunctionalTool as F, type AgentModuleOptions as a, type AgentModuleAsyncOptions as b, AGENT_TOOL_BRAND as c, type AgentDeps as d, delegateToolName as e, provideAgentTool as p, utcDay as u };

package/dist/{agent-deps.factory-D9BHJJqm.d.ts → agent-deps.factory-DpVkZYCy.d.ts}

@@ -1,4 +1,4 @@
-import { ModelProvider, AgentStore, ToolRegistry, RolesPolicy, QuotaStore, TokenStreamSink, PromptBuilder, Persona, Retriever, ToolSpec, ToolHandler, ActorResolver, AgentDefinition, AgentRegistry } from '@dudousxd/nestjs-agent-core';
+import { ModelProvider, AgentStore, ToolRegistry, RolesPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Retriever, ToolSpec, ToolHandler, ActorResolver, AgentRegistry } from '@dudousxd/nestjs-agent-core';
 import { Provider, FactoryProvider, ModuleMetadata, InjectionToken, OptionalFactoryDependency } from '@nestjs/common';
 
 /** Everything `runAgentLoop` needs, minus the per-run `day` the runner stamps. */
@@ -12,10 +12,10 @@ interface AgentDeps {
     /** Fallback accounting label; the provider's turn result overrides it when set. */
     modelId?: string;
     systemPrompt: string | PromptBuilder;
+    /** App-wide `@SystemPromptContributor()` sections appended after the agent's base prompt. */
+    promptContributors: PromptContributor[];
     maxSteps: number;
-    personas: Map<string, Persona>;
-    defaultPersona: string;
-    /** Agent-level tool allow-list (intersected with the persona's). Undefined → all tools. */
+    /** Agent-level tool allow-list. Undefined → all tools (after role filtering). */
     toolAllowList?: string[];
     /** Per-tool execution timeout in ms (from module options). Undefined → no timeout. */
     toolTimeoutMs?: number;
@@ -49,15 +49,6 @@ interface FunctionalTool {
 declare function provideAgentTool(tool: FunctionalTool): Provider;
 declare function provideAgentTool(factory: (...deps: never[]) => FunctionalTool, inject?: FactoryProvider['inject']): Provider;
 
-/**
- * The implicit default agent, configured inline on `forRoot`. It is an {@link AgentDefinition}
- * with `name` optional (defaults to `'default'`) — everything agent-shaped is an AgentDefinition,
- * whether it's this default or one registered via `forFeature`. Omit it entirely for a bare
- * assistant with no base prompt, personas, or tool allow-list.
- */
-type DefaultAgentOptions = Omit<AgentDefinition, 'name'> & {
-    name?: string;
-};
 interface AgentModuleOptions {
     /** The LLM provider (e.g. a Vercel AI SDK wrapper). Required. */
     model: ModelProvider;
@@ -129,10 +120,11 @@ interface AgentModuleOptions {
         topK?: number;
     };
     /**
-     * The implicit single agent's config (base prompt, personas, tool allow-list, model/step
-     * config). Omit for a bare assistant. Additional named agents are added via `forFeature`.
+     * The name of the agent a turn uses when the caller doesn't select one. Omit → the single
+     * discovered `@Agent` (when there is exactly one), else `'default'` (a bare assistant if no
+     * `@Agent` is registered). Agents themselves are declared as `@Agent`-decorated providers, not here.
      */
-    defaultAgent?: DefaultAgentOptions;
+    defaultAgent?: string;
 }
 interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
     inject?: Array<InjectionToken | OptionalFactoryDependency>;
@@ -150,9 +142,9 @@ interface AgentModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
     durable?: boolean;
 }
 
-/** The synthesized `agent`-kind tool name an orchestrator uses to delegate to `target`. */
+/** The synthesized `agent`-kind tool name an orchestrator uses to hand off to `target`. */
 declare function delegateToolName(target: string): string;
-/** Builds the per-agent loop deps. The single-agent case is just the `default` definition. */
+/** Builds the per-agent loop deps. The single-agent case is just the one registered `@Agent`. */
 declare class AgentDepsFactory {
     private readonly options;
     private readonly model;
@@ -161,8 +153,13 @@ declare class AgentDepsFactory {
     private readonly rolesPolicy;
     private readonly registry;
     private readonly agents;
+    private readonly promptContributors;
     private readonly quota;
-    constructor(options: AgentModuleOptions, model: ModelProvider, store: AgentStore, sink: TokenStreamSink, rolesPolicy: RolesPolicy, registry: ToolRegistry, agents: AgentRegistry, quota: QuotaStore | undefined);
+    constructor(options: AgentModuleOptions, model: ModelProvider, store: AgentStore, sink: TokenStreamSink, rolesPolicy: RolesPolicy, registry: ToolRegistry, agents: AgentRegistry, promptContributors: PromptContributor[], quota: QuotaStore | undefined);
+    /**
+     * The agent a turn uses when the caller names none: the explicit `defaultAgent` option, else the
+     * sole registered `@Agent` when there is exactly one, else `'default'` (a bare assistant).
+     */
     defaultAgentName(): string;
     private effectiveTools;
     forAgent(agentName?: string): AgentDeps;
@@ -170,4 +167,4 @@ declare class AgentDepsFactory {
     private followUpsCount;
 }
 
-export { AgentDepsFactory as A, type DefaultAgentOptions as D, type FunctionalTool as F, type AgentModuleOptions as a, type AgentModuleAsyncOptions as b, AGENT_TOOL_BRAND as c, type AgentDeps as d, delegateToolName as e, provideAgentTool as p, utcDay as u };
+export { AgentDepsFactory as A, type FunctionalTool as F, type AgentModuleOptions as a, type AgentModuleAsyncOptions as b, AGENT_TOOL_BRAND as c, type AgentDeps as d, delegateToolName as e, provideAgentTool as p, utcDay as u };