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

package/lib/cjs/prompt/skills/afs/exec.js

@@ -2,15 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AFSExecAgent = void 0;
 const zod_1 = require("zod");
-const agent_js_1 = require("../../../agents/agent.js");
-class AFSExecAgent extends agent_js_1.Agent {
+const base_js_1 = require("./base.js");
+class AFSExecAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_exec",
-            description: "Execute functions or commands from AFS modules. Use when running operations provided by mounted modules.",
+            description: `
+Execute files marked as executable in the Agentic File System (AFS).
+Use this to run executable files registered at a given path with specified arguments.
+      `.trim(),
             ...options,
             inputSchema: zod_1.z.object({
-                path: zod_1.z.string().describe("Absolute path to the executable function in AFS"),
+                path: zod_1.z.string().describe("Absolute path to the executable file in AFS"),
                 args: zod_1.z.string().describe("JSON string of arguments matching the function's input schema"),
             }),
             outputSchema: zod_1.z.object({

package/lib/cjs/prompt/skills/afs/list.d.ts

@@ -1,5 +1,6 @@
 import type { AFSListOptions } 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 AFSListInput extends Message {
     path: string;
     options?: AFSListOptions;
@@ -15,7 +16,7 @@ export interface AFSListOutput extends Message {
 export interface AFSListAgentOptions extends AgentOptions<AFSListInput, AFSListOutput> {
     afs: NonNullable<AgentOptions<AFSListInput, AFSListOutput>["afs"]>;
 }
-export declare class AFSListAgent extends Agent<AFSListInput, AFSListOutput> {
+export declare class AFSListAgent extends AFSSkillBase<AFSListInput, AFSListOutput> {
     constructor(options: AFSListAgentOptions);
     process(input: AFSListInput, _options: AgentInvokeOptions): Promise<AFSListOutput>;
 }

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

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AFSListAgent = void 0;
 const zod_1 = require("zod");
-const agent_js_1 = require("../../../agents/agent.js");
-class AFSListAgent extends agent_js_1.Agent {
+const base_js_1 = require("./base.js");
+class AFSListAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_list",
@@ -23,10 +23,10 @@ class AFSListAgent extends agent_js_1.Agent {
                         .optional()
                         .describe("Maximum number of children to list per directory"),
                     format: zod_1.z
-                        .union([zod_1.z.literal("tree"), zod_1.z.literal("list")])
+                        .union([zod_1.z.literal("simple-list"), zod_1.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(),
             }),
@@ -34,14 +34,7 @@ class AFSListAgent extends agent_js_1.Agent {
                 status: zod_1.z.string(),
                 tool: zod_1.z.string(),
                 path: zod_1.z.string(),
-                options: zod_1.z
-                    .object({
-                    maxDepth: zod_1.z.number().optional(),
-                    disableGitignore: zod_1.z.boolean().optional(),
-                    maxChildren: zod_1.z.number().optional(),
-                    format: zod_1.z.union([zod_1.z.literal("tree"), zod_1.z.literal("list")]).optional(),
-                })
-                    .optional(),
+                options: zod_1.z.record(zod_1.z.any()).optional(),
                 message: zod_1.z.string().optional(),
                 data: zod_1.z.unknown(),
             }),

package/lib/cjs/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/cjs/prompt/skills/afs/read.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AFSReadAgent = void 0;
 const zod_1 = require("zod");
-const agent_js_1 = require("../../../agents/agent.js");
-class AFSReadAgent extends agent_js_1.Agent {
+const base_js_1 = require("./base.js");
+class AFSReadAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_read",

package/lib/cjs/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/cjs/prompt/skills/afs/rename.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AFSRenameAgent = void 0;
 const zod_1 = require("zod");
-const agent_js_1 = require("../../../agents/agent.js");
-class AFSRenameAgent extends agent_js_1.Agent {
+const base_js_1 = require("./base.js");
+class AFSRenameAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_rename",

package/lib/cjs/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/cjs/prompt/skills/afs/search.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AFSSearchAgent = void 0;
 const zod_1 = require("zod");
-const agent_js_1 = require("../../../agents/agent.js");
-class AFSSearchAgent extends agent_js_1.Agent {
+const base_js_1 = require("./base.js");
+class AFSSearchAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_search",

package/lib/cjs/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/cjs/prompt/skills/afs/write.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AFSWriteAgent = void 0;
 const zod_1 = require("zod");
-const agent_js_1 = require("../../../agents/agent.js");
-class AFSWriteAgent extends agent_js_1.Agent {
+const base_js_1 = require("./base.js");
+class AFSWriteAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_write",

package/lib/cjs/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/cjs/prompt/template.js

@@ -80,11 +80,13 @@ 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, ...(0, type_utils_js_1.omitBy)(options ?? {}, (v) => (0, type_utils_js_1.isNil)(v)) };
@@ -103,29 +105,30 @@ class ChatMessageTemplate {
             role: this.role,
             content,
             name: this.name,
+            cacheControl: this.cacheControl,
         };
     }
 }
 exports.ChatMessageTemplate = ChatMessageTemplate;
 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);
     }
 }
 exports.SystemMessageTemplate = SystemMessageTemplate;
 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);
     }
 }
 exports.UserMessageTemplate = UserMessageTemplate;
 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) {
@@ -135,17 +138,18 @@ class AgentMessageTemplate extends ChatMessageTemplate {
             // NOTE: agent message should not rendered by template
             content: this.content,
             toolCalls: this.toolCalls,
+            cacheControl: this.cacheControl,
         };
     }
 }
 exports.AgentMessageTemplate = AgentMessageTemplate;
 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 : (0, yaml_1.stringify)(content), name, options);
+    constructor(content, toolCallId, name, options, cacheControl) {
+        super("tool", typeof content === "string" ? content : (0, yaml_1.stringify)(content), name, options, cacheControl);
         this.toolCallId = toolCallId;
     }
     async format(_variables, _options) {
@@ -155,6 +159,7 @@ class ToolMessageTemplate extends ChatMessageTemplate {
             // NOTE: tool result should not rendered by template
             content: this.content,
             toolCallId: this.toolCallId,
+            cacheControl: this.cacheControl,
         };
     }
 }
@@ -179,11 +184,23 @@ const systemChatMessageSchema = zod_1.z.object({
     role: zod_1.z.literal("system"),
     content: zod_1.z.string(),
     name: zod_1.z.string().optional(),
+    cacheControl: zod_1.z
+        .object({
+        type: zod_1.z.literal("ephemeral"),
+        ttl: zod_1.z.union([zod_1.z.literal("5m"), zod_1.z.literal("1h")]).optional(),
+    })
+        .optional(),
 });
 const userChatMessageSchema = zod_1.z.object({
     role: zod_1.z.literal("user"),
     content: zod_1.z.string(),
     name: zod_1.z.string().optional(),
+    cacheControl: zod_1.z
+        .object({
+        type: zod_1.z.literal("ephemeral"),
+        ttl: zod_1.z.union([zod_1.z.literal("5m"), zod_1.z.literal("1h")]).optional(),
+    })
+        .optional(),
 });
 const chatModelOutputToolCallSchema = zod_1.z.object({
     id: zod_1.z.string(),
@@ -198,6 +215,12 @@ const agentChatMessageSchema = zod_1.z.object({
     content: zod_1.z.string().optional(),
     toolCalls: zod_1.z.array(chatModelOutputToolCallSchema).optional(),
     name: zod_1.z.string().optional(),
+    cacheControl: zod_1.z
+        .object({
+        type: zod_1.z.literal("ephemeral"),
+        ttl: zod_1.z.union([zod_1.z.literal("5m"), zod_1.z.literal("1h")]).optional(),
+    })
+        .optional(),
 });
 const toolChatMessageSchema = zod_1.z.object({
     role: zod_1.z.literal("tool"),
@@ -206,6 +229,12 @@ const toolChatMessageSchema = zod_1.z.object({
         .transform((val) => (typeof val !== "string" ? JSON.stringify(val) : val)),
     toolCallId: zod_1.z.string(),
     name: zod_1.z.string().optional(),
+    cacheControl: zod_1.z
+        .object({
+        type: zod_1.z.literal("ephemeral"),
+        ttl: zod_1.z.union([zod_1.z.literal("5m"), zod_1.z.literal("1h")]).optional(),
+    })
+        .optional(),
 });
 const chatMessageSchema = zod_1.z.union([
     systemChatMessageSchema,
@@ -224,13 +253,13 @@ 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);
         }
     });
 }