bazis 0.98.33 → 0.99.0

package/cli/templates/module.ts

@@ -49,30 +49,24 @@ export function buildModuleTemplates(
   return [
     ...base,
     { relativePath: `background/${naming.module}.reporter.ts`, content: statsReporterFile(naming) },
-    { relativePath: `ai/agents/${naming.module}Analyst.agent.ts`, content: agentFile(naming) },
-    { relativePath: `ai/contracts/${naming.module}.brief.ts`, content: aiContractsFile(naming) },
     { relativePath: `ai/tools/${naming.module}Summary.tool.ts`, content: aiToolFile(naming) },
   ];
 }
 
 function moduleFile(n: ModuleNaming, profile: ModuleTemplateProfile): string {
-  const cacheImport = profile === "full" ? "import { cachedScoped } from \"bazis/core/cache\";\n" : "";
   const moduleImport = "import { Module, scoped } from \"bazis/core/di\";";
-  const providerFactory = profile === "full" ? "cachedScoped" : "scoped";
   const backgroundImport = profile === "full" ? `import { ${n.module}Reporter } from "./background/${n.module}.reporter";\n` : "";
   const aiImports = profile === "full"
-    ? `import { ${n.module}AnalystAgent } from "./ai/agents/${n.module}Analyst.agent";
-import { ${n.module}SummaryTool } from "./ai/tools/${n.module}Summary.tool";
+    ? `import { ${n.module}SummaryTool } from "./ai/tools/${n.module}Summary.tool";
 `
     : "";
   const backgroundLine = profile === "full" ? `  background: [${n.module}Reporter],\n` : "";
   const aiLines = profile === "full"
-    ? `  agents: [${n.module}AnalystAgent],
-  tools: [${n.module}SummaryTool],
+    ? `  tools: [${n.module}SummaryTool],
 `
     : "";
 
-  return `${cacheImport}${moduleImport}
+  return `${moduleImport}
 ${aiImports}${backgroundImport}import { ${n.module}Controller } from "./http/${n.module}.controller";
 import { ${n.entity} } from "./model/${n.module}.model";
 import { ${n.module}DbContext } from "./model/${n.module}.dbContext";
@@ -86,7 +80,7 @@ import { ${n.module}Service } from "./services/${n.module}.service";
   },
   controllers: [${n.module}Controller],
   providers: [
-    ${providerFactory}(I${n.module}Service, ${n.module}Service),
+    scoped(I${n.module}Service, ${n.module}Service),
   ],
 ${backgroundLine}${aiLines}  exports: [I${n.module}Service],
 })
@@ -402,23 +396,6 @@ export class ${n.module}Reporter extends PeriodicBackgroundService {
 `;
 }
 
-function aiContractsFile(n: ModuleNaming): string {
-  return `import { Validator } from "bazis/library/validation";
-
-export class Prepare${n.module}BriefRequest {
-  @Validator({ required: true, minLength: 3 })
-  topic!: string;
-
-  @Validator({ required: true, minLength: 3 })
-  audience = "operators";
-}
-
-export class ${n.module}BriefDocument {
-  title = "";
-  bullets: string[] = [];
-}
-`;
-}
 
 function aiToolFile(n: ModuleNaming): string {
   return `import { Tool, type AgentToolExecutionContext } from "bazis/core/agent";
@@ -460,40 +437,3 @@ export class ${n.module}SummaryTool {
 `;
 }
 
-function agentFile(n: ModuleNaming): string {
-  return `import { Agent, Task, agentOutput } from "bazis/core/agent";
-import { Prepare${n.module}BriefRequest, ${n.module}BriefDocument } from "../contracts/${n.module}.brief";
-import { ${n.module}SummaryTool } from "../tools/${n.module}Summary.tool";
-
-@Agent({
-  name: "${n.route}-analyst",
-  role: "${n.route} analyst",
-  sections: [
-    {
-      kind: "developer",
-      content: "Write short, concrete operational summaries of the ${n.route} domain.",
-    },
-    {
-      kind: "tool-policy",
-      content: "Use read tools before the final summary. Do not make up data.",
-    },
-  ],
-  tools: [${n.module}SummaryTool],
-  modelProfile: "reasoning",
-  maxSteps: 3,
-})
-export class ${n.module}AnalystAgent {
-  @Task({
-    name: "prepare-${n.route}-brief",
-    description: "Prepare a short ${n.route} summary from the current module data.",
-    input: Prepare${n.module}BriefRequest,
-    output: ${n.module}BriefDocument,
-    modelProfile: "reasoning",
-    maxSteps: 3,
-  })
-  prepareBrief(_input: Prepare${n.module}BriefRequest): ${n.module}BriefDocument {
-    return agentOutput();
-  }
-}
-`;
-}

package/cli/templates/passport.ts

@@ -66,9 +66,7 @@ adapters that access it.
 | ${e}Response / ${m}Summary / to${e}Response | [responses](http/contracts/${m}.responses.ts) | ORM entity | Public data projection |
 | ${m}ListQuery | [list](http/contracts/${m}List.query.ts) | Query string | ListQuery, filters/sorting/pages |
 ${profile === "full" ? `| ${m}Reporter | [background](background/${m}.reporter.ts) | ServiceProvider, Logger, AbortSignal | Runs count and logs it |
-| ${m}SummaryTool | [tool](ai/tools/${m}Summary.tool.ts) | I${m}Service, input, context | Summary for the agent |
-| ${m}AnalystAgent | [agent](ai/agents/${m}Analyst.agent.ts) | Prepare${m}BriefRequest | ${m}BriefDocument via AgentRuntime |
-| AI DTO | [contracts](ai/contracts/${m}.brief.ts) | topic, audience | title, bullets |
+| ${m}SummaryTool | [tool](ai/tools/${m}Summary.tool.ts) | I${m}Service, input, context | Summary for an agent |
 ` : ""}
 
 ## Wiring, DI and data
@@ -78,10 +76,10 @@ exports: [I${m}Service]. TypeScript contract: services/I${e}.service.ts;
 HTTP access is defined by the controller and the host policy, separately from DI exports.
 I${m}Service → ${m}Service, scoped lifetime. The context and DbSet belong to the ORM.
 ${profile === "full" ? `${m}SummaryTool is listed in tools: [${m}SummaryTool]; the framework registers it as scoped, the tool is not exported.
-The service uses cachedScoped; ICache comes from the host cacheModule.
+The service is scoped; its keyed @Cacheable works when the host installs the cache (runApp cache: memory()).
 The background service gets its own scope per tick and disposes it in finally.
-The host also provides auth from src/app/modules/auth (TokenKind.Admin/Client),
-AgentRuntime and the reasoning modelProfile. The CLI does not create them.
+The host also provides auth from src/app/modules/auth (TokenKind.Admin/Client)
+and an LLM connector, which registers AgentRuntime. The CLI does not create them.
 ` : ""}Constructor dependencies, including ${m}DbContext, are wired by codegen.
 No manual deps arrays. UI, events and own configuration are not used.
 
@@ -167,21 +165,19 @@ AbortSignal from the runtime, creates a scope, runs count and logs it unless
 the signal is aborted; dispose always runs. The SQL itself is not cancelled by
 this signal.
 
-Tool ${n.route}.summary: execute(input, context), sideEffect read.
-Agent ${n.route}-analyst: prepareBrief(input), task prepare-${n.route}-brief;
-modelProfile reasoning, maxSteps 3. The agentOutput method is a declaration
-for the runtime. Calling prepareBrief directly does not run the LLM.
+Tool ${n.route}.summary: execute(input, context), sideEffect read. Agents are
+data, not classes: an agent definition names the tool in toolNames and runs
+with AgentRuntime.run(definition, { input }).
 
-| AI input field | Type / source | Required | null | Default | Check | Example |
+| Tool input field | Type / source | Required | null | Default | Check | Example |
 | --- | --- | --- | --- | --- | --- | --- |
-| topic | string / tool input or Prepare${n.module}BriefRequest | Yes | no | none | Validator required, minLength 3 | Daily summary |
-| audience | string / Prepare${n.module}BriefRequest | Yes by Validator | no | operators when the DTO is created | Validator required, minLength 3 | operators |
-| context | AgentToolExecutionContext / runtime | For the tool | no | runtime | agentName comes from the server context | agentName: ${n.route}-analyst |
+| topic | string / tool input | Yes | no | none | Validator required, minLength 3 | Daily summary |
+| context | AgentToolExecutionContext / runtime | Yes | no | runtime | agentName comes from the running agent definition | agentName: ${n.route}-analyst |
 
 Tool output: topic string, count number, names string[], agentName string
-(empty when the context has no name). Agent output: title string, bullets
-string[]. AgentRuntime validates AI inputs and reports their errors; the
-scaffold adds no own permission checks for direct DI/tool calls. The host
-decides which tools are allowed. The scaffold does not retry the tool.
+(empty when the context has no name). AgentRuntime validates the tool input
+and reports its errors to the model; the scaffold adds no own permission
+checks. Which agents may call the tool is decided by their definitions'
+toolNames. The scaffold does not retry the tool.
 `;
 }

package/core/agent/AgentContextBuilder.ts

@@ -463,105 +463,11 @@ export class DefaultAgentContextBuilder implements AgentContextBuilder {
     return estimate;
   }
 
+  /** The definition's instructions are the system prompt, sent as written. */
   private promptMessage(agent: AgentDefinition): AgentMessage | undefined {
-    const lines: string[] = [];
-    if (agent.metadata.role !== undefined) {
-      lines.push(`Role: ${agent.metadata.role}`);
-    }
-    if (agent.metadata.description !== undefined) {
-      lines.push(`Description: ${agent.metadata.description}`);
-    }
-    if (agent.metadata.goal !== undefined) {
-      lines.push(`Goal: ${agent.metadata.goal}`);
-    }
-    if (agent.metadata.instructions.length > 0) {
-      lines.push("Instructions:");
-      lines.push(...agent.metadata.instructions.map((item) => `- ${item}`));
-    }
-    if (agent.metadata.constraints.length > 0) {
-      lines.push("Constraints:");
-      lines.push(...agent.metadata.constraints.map((item) => `- ${item}`));
-    }
-    for (let index = 0; index < agent.metadata.sections.length; index += 1) {
-      appendPromptSection(lines, agent.metadata.sections[index] as (typeof agent.metadata.sections)[number]);
-    }
-
-    const prompt = agent.prompt?.metadata;
-    if (prompt !== undefined) {
-      if (prompt.description !== undefined) {
-        lines.push(`Prompt description: ${prompt.description}`);
-      }
-      if (prompt.version !== undefined) {
-        lines.push(`Prompt version: ${prompt.version}`);
-      }
-      if (prompt.role !== undefined) {
-        lines.push(`Prompt role: ${prompt.role}`);
-      }
-      if (prompt.goal !== undefined) {
-        lines.push(`Goal: ${prompt.goal}`);
-      }
-      if (prompt.instructions.length > 0) {
-        lines.push("Instructions:");
-        lines.push(...prompt.instructions.map((item) => `- ${item}`));
-      }
-      if (prompt.constraints.length > 0) {
-        lines.push("Constraints:");
-        lines.push(...prompt.constraints.map((item) => `- ${item}`));
-      }
-      for (let index = 0; index < prompt.sections.length; index += 1) {
-        appendPromptSection(lines, prompt.sections[index] as (typeof prompt.sections)[number]);
-      }
-    }
-
-    return lines.length === 0
+    const instructions = agent.instructions.trim();
+    return instructions.length === 0
       ? undefined
-      : agentMessage("system", lines.join("\n"), {
-          metadata: {
-            agentName: agent.metadata.name,
-            promptName: prompt?.name ?? null,
-            promptSectionKinds: prompt?.sections.map((section) => section.kind) ?? [],
-          },
-        });
-  }
-}
-
-function appendPromptSection(
-  lines: string[],
-  section: { readonly kind: string; readonly title?: string; readonly content: readonly string[] },
-): void {
-  lines.push(`${section.title ?? promptSectionTitle(section.kind)}:`);
-  if (section.content.length === 1) {
-    lines.push(section.content[0] as string);
-    return;
-  }
-  lines.push(...section.content.map((item) => `- ${item}`));
-}
-
-function promptSectionTitle(kind: string): string {
-  switch (kind) {
-    case "system":
-      return "System";
-    case "developer":
-      return "Developer";
-    case "role":
-      return "Role";
-    case "task":
-      return "Task";
-    case "instructions":
-      return "Instructions";
-    case "constraints":
-      return "Constraints";
-    case "examples":
-      return "Examples";
-    case "output":
-      return "Output format";
-    case "tool-policy":
-      return "Tool policy";
-    case "memory":
-      return "Memory";
-    case "knowledge":
-      return "Knowledge";
-    default:
-      return "Prompt section";
+      : agentMessage("system", instructions, { metadata: { agentName: agent.name } });
   }
 }