@aigne/core 1.72.0-beta.1 → 1.72.0-beta.3

package/lib/esm/prompt/skills/afs/list.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { Agent, } from "../../../agents/agent.js";
-export class AFSListAgent extends Agent {
+import { AFSSkillBase } from "./base.js";
+export class AFSListAgent extends AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_list",
@@ -20,10 +20,10 @@ export class AFSListAgent extends Agent {
                         .optional()
                         .describe("Maximum number of children to list per directory"),
                     format: z
-                        .union([z.literal("tree"), z.literal("list")])
+                        .union([z.literal("simple-list"), z.literal("tree")])
                         .optional()
-                        .default("tree")
-                        .describe("Output format, either 'tree' or 'list' (default: 'tree')"),
+                        .default("simple-list")
+                        .describe("Output format, either 'simple-list', or 'tree', default is 'simple-list'"),
                 })
                     .optional(),
             }),
@@ -31,14 +31,7 @@ export class AFSListAgent extends Agent {
                 status: z.string(),
                 tool: z.string(),
                 path: z.string(),
-                options: z
-                    .object({
-                    maxDepth: z.number().optional(),
-                    disableGitignore: z.boolean().optional(),
-                    maxChildren: z.number().optional(),
-                    format: z.union([z.literal("tree"), z.literal("list")]).optional(),
-                })
-                    .optional(),
+                options: z.record(z.any()).optional(),
                 message: z.string().optional(),
                 data: z.unknown(),
             }),

package/lib/esm/prompt/skills/afs/read.d.ts

@@ -1,5 +1,6 @@
 import type { AFSEntry } from "@aigne/afs";
-import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "../../../agents/agent.js";
+import type { AgentInvokeOptions, AgentOptions, Message } from "../../../agents/agent.js";
+import { AFSSkillBase } from "./base.js";
 export interface AFSReadInput extends Message {
     path: string;
     withLineNumbers?: boolean;
@@ -15,7 +16,7 @@ export interface AFSReadOutput extends Message {
 export interface AFSReadAgentOptions extends AgentOptions<AFSReadInput, AFSReadOutput> {
     afs: NonNullable<AgentOptions<AFSReadInput, AFSReadOutput>["afs"]>;
 }
-export declare class AFSReadAgent extends Agent<AFSReadInput, AFSReadOutput> {
+export declare class AFSReadAgent extends AFSSkillBase<AFSReadInput, AFSReadOutput> {
     constructor(options: AFSReadAgentOptions);
     process(input: AFSReadInput, _options: AgentInvokeOptions): Promise<AFSReadOutput>;
 }

package/lib/esm/prompt/skills/afs/read.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { Agent, } from "../../../agents/agent.js";
-export class AFSReadAgent extends Agent {
+import { AFSSkillBase } from "./base.js";
+export class AFSReadAgent extends AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_read",

package/lib/esm/prompt/skills/afs/rename.d.ts

@@ -1,4 +1,5 @@
-import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "../../../agents/agent.js";
+import type { AgentInvokeOptions, AgentOptions, Message } from "../../../agents/agent.js";
+import { AFSSkillBase } from "./base.js";
 export interface AFSRenameInput extends Message {
     oldPath: string;
     newPath: string;
@@ -14,7 +15,7 @@ export interface AFSRenameOutput extends Message {
 export interface AFSRenameAgentOptions extends AgentOptions<AFSRenameInput, AFSRenameOutput> {
     afs: NonNullable<AgentOptions<AFSRenameInput, AFSRenameOutput>["afs"]>;
 }
-export declare class AFSRenameAgent extends Agent<AFSRenameInput, AFSRenameOutput> {
+export declare class AFSRenameAgent extends AFSSkillBase<AFSRenameInput, AFSRenameOutput> {
     constructor(options: AFSRenameAgentOptions);
     process(input: AFSRenameInput, _options: AgentInvokeOptions): Promise<AFSRenameOutput>;
 }

package/lib/esm/prompt/skills/afs/rename.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { Agent, } from "../../../agents/agent.js";
-export class AFSRenameAgent extends Agent {
+import { AFSSkillBase } from "./base.js";
+export class AFSRenameAgent extends AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_rename",

package/lib/esm/prompt/skills/afs/search.d.ts

@@ -1,5 +1,6 @@
 import type { AFSEntry, AFSSearchOptions } from "@aigne/afs";
-import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "../../../agents/agent.js";
+import type { AgentInvokeOptions, AgentOptions, Message } from "../../../agents/agent.js";
+import { AFSSkillBase } from "./base.js";
 export interface AFSSearchInput extends Message {
     path: string;
     query: string;
@@ -17,7 +18,7 @@ export interface AFSSearchOutput extends Message {
 export interface AFSSearchAgentOptions extends AgentOptions<AFSSearchInput, AFSSearchOutput> {
     afs: NonNullable<AgentOptions<AFSSearchInput, AFSSearchOutput>["afs"]>;
 }
-export declare class AFSSearchAgent extends Agent<AFSSearchInput, AFSSearchOutput> {
+export declare class AFSSearchAgent extends AFSSkillBase<AFSSearchInput, AFSSearchOutput> {
     constructor(options: AFSSearchAgentOptions);
     process(input: AFSSearchInput, _options: AgentInvokeOptions): Promise<AFSSearchOutput>;
 }

package/lib/esm/prompt/skills/afs/search.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { Agent, } from "../../../agents/agent.js";
-export class AFSSearchAgent extends Agent {
+import { AFSSkillBase } from "./base.js";
+export class AFSSearchAgent extends AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_search",

package/lib/esm/prompt/skills/afs/write.d.ts

@@ -1,4 +1,5 @@
-import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "../../../agents/agent.js";
+import type { AgentInvokeOptions, AgentOptions, Message } from "../../../agents/agent.js";
+import { AFSSkillBase } from "./base.js";
 export interface AFSWriteInput extends Message {
     path: string;
     content: string;
@@ -13,7 +14,7 @@ export interface AFSWriteOutput extends Message {
 export interface AFSWriteAgentOptions extends AgentOptions<AFSWriteInput, AFSWriteOutput> {
     afs: NonNullable<AgentOptions<AFSWriteInput, AFSWriteOutput>["afs"]>;
 }
-export declare class AFSWriteAgent extends Agent<AFSWriteInput, AFSWriteOutput> {
+export declare class AFSWriteAgent extends AFSSkillBase<AFSWriteInput, AFSWriteOutput> {
     constructor(options: AFSWriteAgentOptions);
     process(input: AFSWriteInput, _options: AgentInvokeOptions): Promise<AFSWriteOutput>;
 }

package/lib/esm/prompt/skills/afs/write.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { Agent, } from "../../../agents/agent.js";
-export class AFSWriteAgent extends Agent {
+import { AFSSkillBase } from "./base.js";
+export class AFSWriteAgent extends AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_write",

package/lib/esm/prompt/template.d.ts

@@ -27,35 +27,38 @@ export declare class ChatMessageTemplate {
     content?: ChatModelInputMessage["content"];
     name?: string | undefined;
     options?: FormatOptions | undefined;
-    constructor(role: "system" | "user" | "agent" | "tool", content?: ChatModelInputMessage["content"], name?: string | undefined, options?: FormatOptions | undefined);
+    cacheControl?: ChatModelInputMessage["cacheControl"];
+    constructor(role: "system" | "user" | "agent" | "tool", content?: ChatModelInputMessage["content"], name?: string | undefined, options?: FormatOptions | undefined, cacheControl?: ChatModelInputMessage["cacheControl"]);
     format(variables?: Record<string, unknown>, options?: FormatOptions): Promise<ChatModelInputMessage>;
 }
 export declare class SystemMessageTemplate extends ChatMessageTemplate {
-    static from(content: string, name?: string, options?: FormatOptions): SystemMessageTemplate;
+    static from(content: string, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]): SystemMessageTemplate;
 }
 export declare class UserMessageTemplate extends ChatMessageTemplate {
-    static from(template: ChatModelInputMessageContent, name?: string, options?: FormatOptions): UserMessageTemplate;
+    static from(template: ChatModelInputMessageContent, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]): UserMessageTemplate;
 }
 export declare class AgentMessageTemplate extends ChatMessageTemplate {
     toolCalls?: ChatModelOutputToolCall[] | undefined;
-    static from(template?: ChatModelInputMessage["content"], toolCalls?: ChatModelOutputToolCall[], name?: string, options?: FormatOptions): AgentMessageTemplate;
-    constructor(content?: ChatModelInputMessage["content"], toolCalls?: ChatModelOutputToolCall[] | undefined, name?: string, options?: FormatOptions);
+    static from(template?: ChatModelInputMessage["content"], toolCalls?: ChatModelOutputToolCall[], name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]): AgentMessageTemplate;
+    constructor(content?: ChatModelInputMessage["content"], toolCalls?: ChatModelOutputToolCall[] | undefined, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]);
     format(_variables?: Record<string, unknown>, _options?: FormatOptions): Promise<{
         role: "agent" | "system" | "user" | "tool";
         name: string | undefined;
         content: ChatModelInputMessageContent | undefined;
         toolCalls: ChatModelOutputToolCall[] | undefined;
+        cacheControl: import("../agents/chat-model.js").CacheControl | undefined;
     }>;
 }
 export declare class ToolMessageTemplate extends ChatMessageTemplate {
     toolCallId: string;
-    static from(content: object | string, toolCallId: string, name?: string, options?: FormatOptions): ToolMessageTemplate;
-    constructor(content: object | string, toolCallId: string, name?: string, options?: FormatOptions);
+    static from(content: object | string, toolCallId: string, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]): ToolMessageTemplate;
+    constructor(content: object | string, toolCallId: string, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]);
     format(_variables?: Record<string, unknown>, _options?: FormatOptions): Promise<{
         role: "agent" | "system" | "user" | "tool";
         name: string | undefined;
         content: ChatModelInputMessageContent | undefined;
         toolCallId: string;
+        cacheControl: import("../agents/chat-model.js").CacheControl | undefined;
     }>;
 }
 export declare class ChatMessagesTemplate {
@@ -69,26 +72,62 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
     role: z.ZodLiteral<"system">;
     content: z.ZodString;
     name: z.ZodOptional<z.ZodString>;
+    cacheControl: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"ephemeral">;
+        ttl: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"5m">, z.ZodLiteral<"1h">]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    }, {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     role: "system";
     content: string;
     name?: string | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
 }, {
     role: "system";
     content: string;
     name?: string | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     role: z.ZodLiteral<"user">;
     content: z.ZodString;
     name: z.ZodOptional<z.ZodString>;
+    cacheControl: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"ephemeral">;
+        ttl: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"5m">, z.ZodLiteral<"1h">]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    }, {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     role: "user";
     content: string;
     name?: string | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
 }, {
     role: "user";
     content: string;
     name?: string | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     role: z.ZodLiteral<"agent">;
     content: z.ZodOptional<z.ZodString>;
@@ -121,6 +160,16 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         id: string;
     }>, "many">>;
     name: z.ZodOptional<z.ZodString>;
+    cacheControl: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"ephemeral">;
+        ttl: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"5m">, z.ZodLiteral<"1h">]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    }, {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     role: "agent";
     name?: string | undefined;
@@ -133,6 +182,10 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         type: "function";
         id: string;
     }[] | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
 }, {
     role: "agent";
     name?: string | undefined;
@@ -145,21 +198,43 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         type: "function";
         id: string;
     }[] | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     role: z.ZodLiteral<"tool">;
     content: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, string, string | Record<string, unknown>>;
     toolCallId: z.ZodString;
     name: z.ZodOptional<z.ZodString>;
+    cacheControl: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"ephemeral">;
+        ttl: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"5m">, z.ZodLiteral<"1h">]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    }, {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     role: "tool";
     content: string;
     toolCallId: string;
     name?: string | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
 }, {
     role: "tool";
     content: string | Record<string, unknown>;
     toolCallId: string;
     name?: string | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
 }>]>;
 export declare function safeParseChatMessages(messages: unknown): ChatMessageTemplate[] | undefined;
 export declare function parseChatMessages(messages: (z.infer<typeof chatMessageSchema> & {

package/lib/esm/prompt/template.js

@@ -70,11 +70,13 @@ export class ChatMessageTemplate {
     content;
     name;
     options;
-    constructor(role, content, name, options) {
+    cacheControl;
+    constructor(role, content, name, options, cacheControl) {
         this.role = role;
         this.content = content;
         this.name = name;
         this.options = options;
+        this.cacheControl = cacheControl;
     }
     async format(variables, options) {
         options = { ...this.options, ...omitBy(options ?? {}, (v) => isNil(v)) };
@@ -93,26 +95,27 @@ export class ChatMessageTemplate {
             role: this.role,
             content,
             name: this.name,
+            cacheControl: this.cacheControl,
         };
     }
 }
 export class SystemMessageTemplate extends ChatMessageTemplate {
-    static from(content, name, options) {
-        return new SystemMessageTemplate("system", content, name, options);
+    static from(content, name, options, cacheControl) {
+        return new SystemMessageTemplate("system", content, name, options, cacheControl);
     }
 }
 export class UserMessageTemplate extends ChatMessageTemplate {
-    static from(template, name, options) {
-        return new UserMessageTemplate("user", template, name, options);
+    static from(template, name, options, cacheControl) {
+        return new UserMessageTemplate("user", template, name, options, cacheControl);
     }
 }
 export class AgentMessageTemplate extends ChatMessageTemplate {
     toolCalls;
-    static from(template, toolCalls, name, options) {
-        return new AgentMessageTemplate(template, toolCalls, name, options);
+    static from(template, toolCalls, name, options, cacheControl) {
+        return new AgentMessageTemplate(template, toolCalls, name, options, cacheControl);
     }
-    constructor(content, toolCalls, name, options) {
-        super("agent", content, name, options);
+    constructor(content, toolCalls, name, options, cacheControl) {
+        super("agent", content, name, options, cacheControl);
         this.toolCalls = toolCalls;
     }
     async format(_variables, _options) {
@@ -122,16 +125,17 @@ export class AgentMessageTemplate extends ChatMessageTemplate {
             // NOTE: agent message should not rendered by template
             content: this.content,
             toolCalls: this.toolCalls,
+            cacheControl: this.cacheControl,
         };
     }
 }
 export class ToolMessageTemplate extends ChatMessageTemplate {
     toolCallId;
-    static from(content, toolCallId, name, options) {
-        return new ToolMessageTemplate(content, toolCallId, name, options);
+    static from(content, toolCallId, name, options, cacheControl) {
+        return new ToolMessageTemplate(content, toolCallId, name, options, cacheControl);
     }
-    constructor(content, toolCallId, name, options) {
-        super("tool", typeof content === "string" ? content : stringify(content), name, options);
+    constructor(content, toolCallId, name, options, cacheControl) {
+        super("tool", typeof content === "string" ? content : stringify(content), name, options, cacheControl);
         this.toolCallId = toolCallId;
     }
     async format(_variables, _options) {
@@ -141,6 +145,7 @@ export class ToolMessageTemplate extends ChatMessageTemplate {
             // NOTE: tool result should not rendered by template
             content: this.content,
             toolCallId: this.toolCallId,
+            cacheControl: this.cacheControl,
         };
     }
 }
@@ -163,11 +168,23 @@ const systemChatMessageSchema = z.object({
     role: z.literal("system"),
     content: z.string(),
     name: z.string().optional(),
+    cacheControl: z
+        .object({
+        type: z.literal("ephemeral"),
+        ttl: z.union([z.literal("5m"), z.literal("1h")]).optional(),
+    })
+        .optional(),
 });
 const userChatMessageSchema = z.object({
     role: z.literal("user"),
     content: z.string(),
     name: z.string().optional(),
+    cacheControl: z
+        .object({
+        type: z.literal("ephemeral"),
+        ttl: z.union([z.literal("5m"), z.literal("1h")]).optional(),
+    })
+        .optional(),
 });
 const chatModelOutputToolCallSchema = z.object({
     id: z.string(),
@@ -182,6 +199,12 @@ const agentChatMessageSchema = z.object({
     content: z.string().optional(),
     toolCalls: z.array(chatModelOutputToolCallSchema).optional(),
     name: z.string().optional(),
+    cacheControl: z
+        .object({
+        type: z.literal("ephemeral"),
+        ttl: z.union([z.literal("5m"), z.literal("1h")]).optional(),
+    })
+        .optional(),
 });
 const toolChatMessageSchema = z.object({
     role: z.literal("tool"),
@@ -190,6 +213,12 @@ const toolChatMessageSchema = z.object({
         .transform((val) => (typeof val !== "string" ? JSON.stringify(val) : val)),
     toolCallId: z.string(),
     name: z.string().optional(),
+    cacheControl: z
+        .object({
+        type: z.literal("ephemeral"),
+        ttl: z.union([z.literal("5m"), z.literal("1h")]).optional(),
+    })
+        .optional(),
 });
 const chatMessageSchema = z.union([
     systemChatMessageSchema,
@@ -208,13 +237,13 @@ export function parseChatMessages(messages) {
     return messages.map((message) => {
         switch (message.role) {
             case "system":
-                return SystemMessageTemplate.from(message.content, message.name, message.options);
+                return SystemMessageTemplate.from(message.content, message.name, message.options, message.cacheControl);
             case "user":
-                return UserMessageTemplate.from(message.content, message.name, message.options);
+                return UserMessageTemplate.from(message.content, message.name, message.options, message.cacheControl);
             case "agent":
-                return AgentMessageTemplate.from(message.content, message.toolCalls, message.name, message.options);
+                return AgentMessageTemplate.from(message.content, message.toolCalls, message.name, message.options, message.cacheControl);
             case "tool":
-                return ToolMessageTemplate.from(message.content, message.toolCallId, message.name, message.options);
+                return ToolMessageTemplate.from(message.content, message.toolCallId, message.name, message.options, message.cacheControl);
         }
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.72.0-beta.1",
+  "version": "1.72.0-beta.3",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -92,10 +92,10 @@
     "zod": "^3.25.67",
     "zod-from-json-schema": "^0.0.5",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/afs": "^1.4.0-beta.1",
-    "@aigne/afs-history": "^1.2.0-beta.1",
-    "@aigne/observability-api": "^0.11.14-beta",
-    "@aigne/platform-helpers": "^0.6.7-beta"
+    "@aigne/afs": "^1.4.0-beta.2",
+    "@aigne/platform-helpers": "^0.6.7-beta",
+    "@aigne/observability-api": "^0.11.14-beta.1",
+    "@aigne/afs-history": "^1.2.0-beta.2"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",