@aigne/core 1.50.1 → 1.51.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.51.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.50.1...core-v1.51.0) (2025-08-18)
+
+
+### Features
+
+* **cli:** support hide or collapse task for agents in CLI ([#381](https://github.com/AIGNE-io/aigne-framework/issues/381)) ([05b372d](https://github.com/AIGNE-io/aigne-framework/commit/05b372d431a862f7cdfa2a90bb4b7b2379bf97ab))
+
 ## [1.50.1](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.50.0...core-v1.50.1) (2025-08-16)
 
 

package/lib/cjs/agents/agent.d.ts

@@ -33,6 +33,7 @@ export type SubscribeTopic = string | string[];
  * @template O The agent output message type
  */
 export type PublishTopic<O extends Message> = string | string[] | ((output: O) => PromiseOrValue<Nullish<string | string[]>>);
+export type TaskRenderMode = "hide" | "collapse";
 /**
  * Configuration options for an agent
  *
@@ -73,6 +74,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      */
     description?: string;
     taskTitle?: string | ((input: I) => PromiseOrValue<string | undefined>);
+    taskRenderMode?: TaskRenderMode;
     /**
      * Zod schema defining the input message structure
      *
@@ -259,6 +261,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
     readonly description?: string;
     taskTitle?: string | ((input: Message) => PromiseOrValue<string | undefined>);
     renderTaskTitle(input: I): Promise<string | undefined>;
+    taskRenderMode?: TaskRenderMode;
     private readonly _inputSchema?;
     defaultInput?: Partial<{
         [key in keyof I]: {

package/lib/cjs/agents/agent.js

@@ -111,6 +111,7 @@ class Agent {
         this.alias = options.alias;
         this.description = options.description;
         this.taskTitle = options.taskTitle;
+        this.taskRenderMode = options.taskRenderMode;
         if (inputSchema)
             checkAgentInputOutputSchema(inputSchema);
         if (outputSchema)
@@ -209,6 +210,7 @@ class Agent {
             return;
         return nunjucks_1.default.renderString(s, { ...input });
     }
+    taskRenderMode;
     _inputSchema;
     defaultInput;
     _outputSchema;

package/lib/cjs/agents/chat-model.js

@@ -138,6 +138,8 @@ class ChatModel extends agent_js_1.Agent {
         if (usage) {
             options.context.usage.outputTokens += usage.outputTokens;
             options.context.usage.inputTokens += usage.inputTokens;
+            if (usage.aigneHubCredits)
+                options.context.usage.aigneHubCredits += usage.aigneHubCredits;
         }
     }
 }

package/lib/cjs/aigne/usage.d.ts

@@ -4,6 +4,7 @@
 export interface ContextUsage {
     inputTokens: number;
     outputTokens: number;
+    aigneHubCredits: number;
     agentCalls: number;
     duration: number;
 }
@@ -19,3 +20,4 @@ export interface ContextLimits {
     maxAgentInvokes?: number;
     timeout?: number;
 }
+export declare function mergeContextUsage(usage: ContextUsage, additional: Partial<ContextUsage>): void;

package/lib/cjs/aigne/usage.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.newEmptyContextUsage = newEmptyContextUsage;
+exports.mergeContextUsage = mergeContextUsage;
 /**
  * @hidden
  */
@@ -8,7 +9,20 @@ function newEmptyContextUsage() {
     return {
         inputTokens: 0,
         outputTokens: 0,
+        aigneHubCredits: 0,
         agentCalls: 0,
         duration: 0,
     };
 }
+function mergeContextUsage(usage, additional) {
+    if (additional.inputTokens)
+        usage.inputTokens += additional.inputTokens;
+    if (additional.outputTokens)
+        usage.outputTokens += additional.outputTokens;
+    if (additional.aigneHubCredits)
+        usage.aigneHubCredits += additional.aigneHubCredits;
+    if (additional.agentCalls)
+        usage.agentCalls += additional.agentCalls;
+    if (additional.duration)
+        usage.duration += additional.duration;
+}

package/lib/cjs/loader/agent-yaml.d.ts

@@ -1,5 +1,5 @@
 import { type ZodType } from "zod";
-import type { AgentHooks, FunctionAgentFn } from "../agents/agent.js";
+import type { AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
 import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
 export interface HooksSchema {
@@ -21,6 +21,7 @@ export interface BaseAgentSchema {
     name?: string;
     description?: string;
     taskTitle?: string;
+    taskRenderMode?: TaskRenderMode;
     inputSchema?: ZodType<Record<string, any>>;
     defaultInput?: Record<string, any>;
     outputSchema?: ZodType<Record<string, any>>;

package/lib/cjs/loader/agent-yaml.js

@@ -36,6 +36,7 @@ async function parseAgentFile(path, data) {
             alias: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.string())),
             description: (0, schema_js_1.optionalize)(zod_1.z.string()),
             taskTitle: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            taskRenderMode: (0, schema_js_1.optionalize)(zod_1.z.union([zod_1.z.literal("hide"), zod_1.z.literal("collapse")])),
             inputSchema: (0, schema_js_1.optionalize)((0, schema_js_1.inputOutputSchema)({ path })).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
             defaultInput: (0, schema_js_1.optionalize)(schema_js_1.defaultInputSchema),
             outputSchema: (0, schema_js_1.optionalize)((0, schema_js_1.inputOutputSchema)({ path })).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),

package/lib/dts/agents/agent.d.ts

@@ -33,6 +33,7 @@ export type SubscribeTopic = string | string[];
  * @template O The agent output message type
  */
 export type PublishTopic<O extends Message> = string | string[] | ((output: O) => PromiseOrValue<Nullish<string | string[]>>);
+export type TaskRenderMode = "hide" | "collapse";
 /**
  * Configuration options for an agent
  *
@@ -73,6 +74,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      */
     description?: string;
     taskTitle?: string | ((input: I) => PromiseOrValue<string | undefined>);
+    taskRenderMode?: TaskRenderMode;
     /**
      * Zod schema defining the input message structure
      *
@@ -259,6 +261,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
     readonly description?: string;
     taskTitle?: string | ((input: Message) => PromiseOrValue<string | undefined>);
     renderTaskTitle(input: I): Promise<string | undefined>;
+    taskRenderMode?: TaskRenderMode;
     private readonly _inputSchema?;
     defaultInput?: Partial<{
         [key in keyof I]: {

package/lib/dts/aigne/usage.d.ts

@@ -4,6 +4,7 @@
 export interface ContextUsage {
     inputTokens: number;
     outputTokens: number;
+    aigneHubCredits: number;
     agentCalls: number;
     duration: number;
 }
@@ -19,3 +20,4 @@ export interface ContextLimits {
     maxAgentInvokes?: number;
     timeout?: number;
 }
+export declare function mergeContextUsage(usage: ContextUsage, additional: Partial<ContextUsage>): void;

package/lib/dts/loader/agent-yaml.d.ts

@@ -1,5 +1,5 @@
 import { type ZodType } from "zod";
-import type { AgentHooks, FunctionAgentFn } from "../agents/agent.js";
+import type { AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
 import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
 export interface HooksSchema {
@@ -21,6 +21,7 @@ export interface BaseAgentSchema {
     name?: string;
     description?: string;
     taskTitle?: string;
+    taskRenderMode?: TaskRenderMode;
     inputSchema?: ZodType<Record<string, any>>;
     defaultInput?: Record<string, any>;
     outputSchema?: ZodType<Record<string, any>>;

package/lib/esm/agents/agent.d.ts

@@ -33,6 +33,7 @@ export type SubscribeTopic = string | string[];
  * @template O The agent output message type
  */
 export type PublishTopic<O extends Message> = string | string[] | ((output: O) => PromiseOrValue<Nullish<string | string[]>>);
+export type TaskRenderMode = "hide" | "collapse";
 /**
  * Configuration options for an agent
  *
@@ -73,6 +74,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      */
     description?: string;
     taskTitle?: string | ((input: I) => PromiseOrValue<string | undefined>);
+    taskRenderMode?: TaskRenderMode;
     /**
      * Zod schema defining the input message structure
      *
@@ -259,6 +261,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
     readonly description?: string;
     taskTitle?: string | ((input: Message) => PromiseOrValue<string | undefined>);
     renderTaskTitle(input: I): Promise<string | undefined>;
+    taskRenderMode?: TaskRenderMode;
     private readonly _inputSchema?;
     defaultInput?: Partial<{
         [key in keyof I]: {

package/lib/esm/agents/agent.js

@@ -63,6 +63,7 @@ export class Agent {
         this.alias = options.alias;
         this.description = options.description;
         this.taskTitle = options.taskTitle;
+        this.taskRenderMode = options.taskRenderMode;
         if (inputSchema)
             checkAgentInputOutputSchema(inputSchema);
         if (outputSchema)
@@ -161,6 +162,7 @@ export class Agent {
             return;
         return nunjucks.renderString(s, { ...input });
     }
+    taskRenderMode;
     _inputSchema;
     defaultInput;
     _outputSchema;

package/lib/esm/agents/chat-model.js

@@ -135,6 +135,8 @@ export class ChatModel extends Agent {
         if (usage) {
             options.context.usage.outputTokens += usage.outputTokens;
             options.context.usage.inputTokens += usage.inputTokens;
+            if (usage.aigneHubCredits)
+                options.context.usage.aigneHubCredits += usage.aigneHubCredits;
         }
     }
 }

package/lib/esm/aigne/usage.d.ts

@@ -4,6 +4,7 @@
 export interface ContextUsage {
     inputTokens: number;
     outputTokens: number;
+    aigneHubCredits: number;
     agentCalls: number;
     duration: number;
 }
@@ -19,3 +20,4 @@ export interface ContextLimits {
     maxAgentInvokes?: number;
     timeout?: number;
 }
+export declare function mergeContextUsage(usage: ContextUsage, additional: Partial<ContextUsage>): void;

package/lib/esm/aigne/usage.js

@@ -5,7 +5,20 @@ export function newEmptyContextUsage() {
     return {
         inputTokens: 0,
         outputTokens: 0,
+        aigneHubCredits: 0,
         agentCalls: 0,
         duration: 0,
     };
 }
+export function mergeContextUsage(usage, additional) {
+    if (additional.inputTokens)
+        usage.inputTokens += additional.inputTokens;
+    if (additional.outputTokens)
+        usage.outputTokens += additional.outputTokens;
+    if (additional.aigneHubCredits)
+        usage.aigneHubCredits += additional.aigneHubCredits;
+    if (additional.agentCalls)
+        usage.agentCalls += additional.agentCalls;
+    if (additional.duration)
+        usage.duration += additional.duration;
+}

package/lib/esm/loader/agent-yaml.d.ts

@@ -1,5 +1,5 @@
 import { type ZodType } from "zod";
-import type { AgentHooks, FunctionAgentFn } from "../agents/agent.js";
+import type { AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
 import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
 export interface HooksSchema {
@@ -21,6 +21,7 @@ export interface BaseAgentSchema {
     name?: string;
     description?: string;
     taskTitle?: string;
+    taskRenderMode?: TaskRenderMode;
     inputSchema?: ZodType<Record<string, any>>;
     defaultInput?: Record<string, any>;
     outputSchema?: ZodType<Record<string, any>>;

package/lib/esm/loader/agent-yaml.js

@@ -32,6 +32,7 @@ export async function parseAgentFile(path, data) {
             alias: optionalize(z.array(z.string())),
             description: optionalize(z.string()),
             taskTitle: optionalize(z.string()),
+            taskRenderMode: optionalize(z.union([z.literal("hide"), z.literal("collapse")])),
             inputSchema: optionalize(inputOutputSchema({ path })).transform((v) => v ? jsonSchemaToZod(v) : undefined),
             defaultInput: optionalize(defaultInputSchema),
             outputSchema: optionalize(inputOutputSchema({ path })).transform((v) => v ? jsonSchemaToZod(v) : undefined),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.50.1",
+  "version": "1.51.0",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"