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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/lib/cjs/agents/agent.d.ts +31 -1
  3. package/lib/cjs/agents/agent.js +13 -0
  4. package/lib/cjs/agents/ai-agent.d.ts +7 -0
  5. package/lib/cjs/agents/ai-agent.js +85 -3
  6. package/lib/cjs/agents/image-agent.d.ts +17 -1
  7. package/lib/cjs/agents/image-agent.js +16 -0
  8. package/lib/cjs/agents/image-model.d.ts +4 -4
  9. package/lib/cjs/agents/mcp-agent.d.ts +17 -0
  10. package/lib/cjs/agents/mcp-agent.js +18 -0
  11. package/lib/cjs/agents/team-agent.d.ts +55 -0
  12. package/lib/cjs/agents/team-agent.js +31 -0
  13. package/lib/cjs/agents/transform-agent.d.ts +12 -0
  14. package/lib/cjs/agents/transform-agent.js +13 -0
  15. package/lib/cjs/agents/video-model.d.ts +4 -4
  16. package/lib/cjs/loader/agent-yaml.d.ts +5 -67
  17. package/lib/cjs/loader/agent-yaml.js +4 -139
  18. package/lib/cjs/loader/agents.d.ts +4 -0
  19. package/lib/cjs/loader/agents.js +17 -0
  20. package/lib/cjs/loader/index.d.ts +18 -14
  21. package/lib/cjs/loader/index.js +20 -81
  22. package/lib/cjs/loader/schema.d.ts +21 -6
  23. package/lib/cjs/loader/schema.js +60 -1
  24. package/lib/cjs/prompt/prompt-builder.js +0 -1
  25. package/lib/cjs/prompt/skills/afs/agent-skill/agent-skill.d.ts +17 -0
  26. package/lib/cjs/prompt/skills/afs/agent-skill/agent-skill.js +63 -0
  27. package/lib/cjs/prompt/skills/afs/agent-skill/skill-loader.d.ts +13 -0
  28. package/lib/cjs/prompt/skills/afs/agent-skill/skill-loader.js +61 -0
  29. package/lib/cjs/prompt/skills/afs/delete.js +15 -3
  30. package/lib/cjs/prompt/skills/afs/edit.js +30 -7
  31. package/lib/cjs/prompt/skills/afs/exec.js +17 -6
  32. package/lib/cjs/prompt/skills/afs/index.js +4 -1
  33. package/lib/cjs/prompt/skills/afs/list.js +26 -10
  34. package/lib/cjs/prompt/skills/afs/read.js +14 -3
  35. package/lib/cjs/prompt/skills/afs/rename.js +18 -4
  36. package/lib/cjs/prompt/skills/afs/search.js +21 -5
  37. package/lib/cjs/prompt/skills/afs/write.js +18 -4
  38. package/lib/cjs/prompt/template.d.ts +23 -23
  39. package/lib/dts/agents/agent.d.ts +31 -1
  40. package/lib/dts/agents/ai-agent.d.ts +7 -0
  41. package/lib/dts/agents/image-agent.d.ts +17 -1
  42. package/lib/dts/agents/image-model.d.ts +4 -4
  43. package/lib/dts/agents/mcp-agent.d.ts +17 -0
  44. package/lib/dts/agents/team-agent.d.ts +55 -0
  45. package/lib/dts/agents/transform-agent.d.ts +12 -0
  46. package/lib/dts/agents/video-model.d.ts +4 -4
  47. package/lib/dts/aigne/context.d.ts +2 -2
  48. package/lib/dts/loader/agent-yaml.d.ts +5 -67
  49. package/lib/dts/loader/agents.d.ts +4 -0
  50. package/lib/dts/loader/index.d.ts +18 -14
  51. package/lib/dts/loader/schema.d.ts +21 -6
  52. package/lib/dts/prompt/skills/afs/agent-skill/agent-skill.d.ts +17 -0
  53. package/lib/dts/prompt/skills/afs/agent-skill/skill-loader.d.ts +13 -0
  54. package/lib/dts/prompt/template.d.ts +25 -25
  55. package/lib/esm/agents/agent.d.ts +31 -1
  56. package/lib/esm/agents/agent.js +13 -0
  57. package/lib/esm/agents/ai-agent.d.ts +7 -0
  58. package/lib/esm/agents/ai-agent.js +85 -3
  59. package/lib/esm/agents/image-agent.d.ts +17 -1
  60. package/lib/esm/agents/image-agent.js +16 -0
  61. package/lib/esm/agents/image-model.d.ts +4 -4
  62. package/lib/esm/agents/mcp-agent.d.ts +17 -0
  63. package/lib/esm/agents/mcp-agent.js +18 -0
  64. package/lib/esm/agents/team-agent.d.ts +55 -0
  65. package/lib/esm/agents/team-agent.js +31 -0
  66. package/lib/esm/agents/transform-agent.d.ts +12 -0
  67. package/lib/esm/agents/transform-agent.js +13 -0
  68. package/lib/esm/agents/video-model.d.ts +4 -4
  69. package/lib/esm/aigne/context.d.ts +2 -2
  70. package/lib/esm/loader/agent-yaml.d.ts +5 -67
  71. package/lib/esm/loader/agent-yaml.js +4 -138
  72. package/lib/esm/loader/agents.d.ts +4 -0
  73. package/lib/esm/loader/agents.js +14 -0
  74. package/lib/esm/loader/index.d.ts +18 -14
  75. package/lib/esm/loader/index.js +21 -81
  76. package/lib/esm/loader/schema.d.ts +21 -6
  77. package/lib/esm/loader/schema.js +57 -0
  78. package/lib/esm/prompt/prompt-builder.js +1 -2
  79. package/lib/esm/prompt/skills/afs/agent-skill/agent-skill.d.ts +17 -0
  80. package/lib/esm/prompt/skills/afs/agent-skill/agent-skill.js +59 -0
  81. package/lib/esm/prompt/skills/afs/agent-skill/skill-loader.d.ts +13 -0
  82. package/lib/esm/prompt/skills/afs/agent-skill/skill-loader.js +53 -0
  83. package/lib/esm/prompt/skills/afs/delete.js +15 -3
  84. package/lib/esm/prompt/skills/afs/edit.js +30 -7
  85. package/lib/esm/prompt/skills/afs/exec.js +17 -6
  86. package/lib/esm/prompt/skills/afs/index.js +4 -1
  87. package/lib/esm/prompt/skills/afs/list.js +26 -10
  88. package/lib/esm/prompt/skills/afs/read.js +14 -3
  89. package/lib/esm/prompt/skills/afs/rename.js +18 -4
  90. package/lib/esm/prompt/skills/afs/search.js +21 -5
  91. package/lib/esm/prompt/skills/afs/write.js +18 -4
  92. package/lib/esm/prompt/template.d.ts +25 -25
  93. package/package.json +5 -4
@@ -91,6 +91,7 @@ export declare const imageModelInputSchema: z.ZodObject<{
91
91
  }, "strip", z.ZodTypeAny, {
92
92
  prompt: string;
93
93
  modelOptions?: Record<string, unknown> | undefined;
94
+ outputFileType?: "local" | "url" | "file" | undefined;
94
95
  image?: ({
95
96
  type: "url";
96
97
  url: string;
@@ -107,11 +108,11 @@ export declare const imageModelInputSchema: z.ZodObject<{
107
108
  filename?: string | undefined;
108
109
  mimeType?: string | undefined;
109
110
  })[] | undefined;
110
- outputFileType?: "local" | "file" | "url" | undefined;
111
111
  n?: number | undefined;
112
112
  }, {
113
113
  prompt: string;
114
114
  modelOptions?: Record<string, unknown> | undefined;
115
+ outputFileType?: "local" | "url" | "file" | undefined;
115
116
  image?: ({
116
117
  type: "url";
117
118
  url: string;
@@ -128,7 +129,6 @@ export declare const imageModelInputSchema: z.ZodObject<{
128
129
  filename?: string | undefined;
129
130
  mimeType?: string | undefined;
130
131
  })[] | undefined;
131
- outputFileType?: "local" | "file" | "url" | undefined;
132
132
  n?: number | undefined;
133
133
  }>;
134
134
  export interface ImageModelOutput extends Message {
@@ -232,7 +232,6 @@ export declare const imageModelOutputSchema: z.ZodObject<{
232
232
  filename?: string | undefined;
233
233
  mimeType?: string | undefined;
234
234
  })[];
235
- model?: string | undefined;
236
235
  usage?: {
237
236
  inputTokens: number;
238
237
  outputTokens: number;
@@ -241,6 +240,7 @@ export declare const imageModelOutputSchema: z.ZodObject<{
241
240
  cacheReadInputTokens?: number | undefined;
242
241
  creditPrefix?: "$" | "€" | "¥" | undefined;
243
242
  } | undefined;
243
+ model?: string | undefined;
244
244
  }, {
245
245
  images: ({
246
246
  type: "url";
@@ -258,7 +258,6 @@ export declare const imageModelOutputSchema: z.ZodObject<{
258
258
  filename?: string | undefined;
259
259
  mimeType?: string | undefined;
260
260
  })[];
261
- model?: string | undefined;
262
261
  usage?: {
263
262
  inputTokens: number;
264
263
  outputTokens: number;
@@ -267,4 +266,5 @@ export declare const imageModelOutputSchema: z.ZodObject<{
267
266
  cacheReadInputTokens?: number | undefined;
268
267
  creditPrefix?: "$" | "€" | "¥" | undefined;
269
268
  } | undefined;
269
+ model?: string | undefined;
270
270
  }>;
@@ -58,6 +58,23 @@ export type SSEServerParameters = {
58
58
  */
59
59
  export declare class MCPAgent extends Agent {
60
60
  tag: string;
61
+ static schema(): z.ZodObject<{
62
+ url: ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
63
+ command: ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
64
+ args: ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
65
+ }, "strip", z.ZodTypeAny, {
66
+ url?: string | undefined;
67
+ args?: string[] | undefined;
68
+ command?: string | undefined;
69
+ }, {
70
+ url?: string | undefined;
71
+ args?: string[] | undefined;
72
+ command?: string | undefined;
73
+ }>;
74
+ static load<I extends Message = any, O extends Message = any>(options: {
75
+ filepath: string;
76
+ parsed: object;
77
+ }): Promise<Agent<I, O>>;
61
78
  /**
62
79
  * Create an MCPAgent from a connection to an SSE server.
63
80
  *
@@ -5,6 +5,7 @@ import { SSEClientTransport, } from "@modelcontextprotocol/sdk/client/sse.js";
5
5
  import { StreamableHTTPClientTransport, } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
6
6
  import { UriTemplate } from "@modelcontextprotocol/sdk/shared/uriTemplate.js";
7
7
  import { z } from "zod";
8
+ import { optionalize } from "../loader/schema.js";
8
9
  import { logger } from "../utils/logger.js";
9
10
  import { promptFromMCPPrompt, resourceFromMCPResource, toolFromMCPTool, } from "../utils/mcp-utils.js";
10
11
  import { checkArguments, createAccessorArray } from "../utils/type-utils.js";
@@ -49,6 +50,23 @@ function getMCPServerString(options) {
49
50
  */
50
51
  export class MCPAgent extends Agent {
51
52
  tag = "MCPAgent";
53
+ static schema() {
54
+ return z.object({
55
+ url: optionalize(z.string()),
56
+ command: optionalize(z.string()),
57
+ args: optionalize(z.array(z.string())),
58
+ });
59
+ }
60
+ static async load(options) {
61
+ const valid = await MCPAgent.schema().parseAsync(options.parsed);
62
+ if (!valid.url && !valid.command) {
63
+ throw new Error(`Missing url or command in mcp agent: ${options.filepath}`);
64
+ }
65
+ return MCPAgent.from({
66
+ ...options.parsed,
67
+ ...valid,
68
+ });
69
+ }
52
70
  static from(options) {
53
71
  checkArguments("MCPAgent.from", mcpAgentOptionsSchema, options);
54
72
  if (isSSEServerParameters(options)) {
@@ -1,3 +1,5 @@
1
+ import { z } from "zod";
2
+ import type { AgentLoadOptions } from "../loader/index.js";
1
3
  import { type PromiseOrValue } from "../utils/type-utils.js";
2
4
  import { Agent, type AgentInvokeOptions, type AgentOptions, type AgentProcessResult, type Message } from "./agent.js";
3
5
  /**
@@ -200,6 +202,59 @@ export interface TeamAgentOptions<I extends Message, O extends Message> extends
200
202
  */
201
203
  export declare class TeamAgent<I extends Message, O extends Message> extends Agent<I, O> {
202
204
  tag: string;
205
+ static schema({ filepath }: {
206
+ filepath: string;
207
+ }): z.ZodObject<{
208
+ mode: z.ZodType<ProcessMode | undefined, z.ZodTypeDef, ProcessMode | undefined>;
209
+ iterateOn: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
210
+ concurrency: z.ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
211
+ iterateWithPreviousOutput: z.ZodType<boolean | undefined, z.ZodTypeDef, boolean | undefined>;
212
+ includeAllStepsOutput: z.ZodType<boolean | undefined, z.ZodTypeDef, boolean | undefined>;
213
+ reflection: z.ZodType<{
214
+ reviewer: import("../loader/agent-yaml.js").NestAgentSchema;
215
+ isApproved: string;
216
+ maxIterations?: number | undefined;
217
+ returnLastOnMaxIterations?: boolean | undefined;
218
+ customErrorMessage?: string | undefined;
219
+ } | undefined, z.ZodTypeDef, {
220
+ reviewer: import("../loader/agent-yaml.js").NestAgentSchema;
221
+ isApproved: string;
222
+ maxIterations?: number | undefined;
223
+ returnLastOnMaxIterations?: boolean | undefined;
224
+ customErrorMessage?: string | undefined;
225
+ } | undefined>;
226
+ }, "strip", z.ZodTypeAny, {
227
+ mode?: ProcessMode | undefined;
228
+ reflection?: {
229
+ reviewer: import("../loader/agent-yaml.js").NestAgentSchema;
230
+ isApproved: string;
231
+ maxIterations?: number | undefined;
232
+ returnLastOnMaxIterations?: boolean | undefined;
233
+ customErrorMessage?: string | undefined;
234
+ } | undefined;
235
+ iterateOn?: string | undefined;
236
+ concurrency?: number | undefined;
237
+ iterateWithPreviousOutput?: boolean | undefined;
238
+ includeAllStepsOutput?: boolean | undefined;
239
+ }, {
240
+ mode?: ProcessMode | undefined;
241
+ reflection?: {
242
+ reviewer: import("../loader/agent-yaml.js").NestAgentSchema;
243
+ isApproved: string;
244
+ maxIterations?: number | undefined;
245
+ returnLastOnMaxIterations?: boolean | undefined;
246
+ customErrorMessage?: string | undefined;
247
+ } | undefined;
248
+ iterateOn?: string | undefined;
249
+ concurrency?: number | undefined;
250
+ iterateWithPreviousOutput?: boolean | undefined;
251
+ includeAllStepsOutput?: boolean | undefined;
252
+ }>;
253
+ static load<I extends Message = any, O extends Message = any>(options: {
254
+ filepath: string;
255
+ parsed: object;
256
+ options: AgentLoadOptions;
257
+ }): Promise<Agent<I, O>>;
203
258
  /**
204
259
  * Create a TeamAgent from the provided options.
205
260
  *
@@ -1,5 +1,8 @@
1
1
  import assert from "node:assert";
2
2
  import { produce } from "immer";
3
+ import { z } from "zod";
4
+ import { getNestAgentSchema } from "../loader/agent-yaml.js";
5
+ import { camelizeSchema, optionalize } from "../loader/schema.js";
3
6
  import * as fastq from "../utils/queue.js";
4
7
  import { mergeAgentResponseChunk } from "../utils/stream-utils.js";
5
8
  import { isEmpty, isNil, isRecord, omit } from "../utils/type-utils.js";
@@ -47,6 +50,34 @@ export const DEFAULT_REFLECTION_MAX_ITERATIONS = 3;
47
50
  */
48
51
  export class TeamAgent extends Agent {
49
52
  tag = "TeamAgent";
53
+ static schema({ filepath }) {
54
+ const nestAgentSchema = getNestAgentSchema({ filepath });
55
+ return z.object({
56
+ mode: optionalize(z.nativeEnum(ProcessMode)),
57
+ iterateOn: optionalize(z.string()),
58
+ concurrency: optionalize(z.number().int().min(1)),
59
+ iterateWithPreviousOutput: optionalize(z.boolean()),
60
+ includeAllStepsOutput: optionalize(z.boolean()),
61
+ reflection: camelizeSchema(optionalize(z.object({
62
+ reviewer: nestAgentSchema,
63
+ isApproved: z.string(),
64
+ maxIterations: optionalize(z.number().int().min(1)),
65
+ returnLastOnMaxIterations: optionalize(z.boolean()),
66
+ customErrorMessage: optionalize(z.string()),
67
+ }))),
68
+ });
69
+ }
70
+ static async load(options) {
71
+ const valid = await TeamAgent.schema({ filepath: options.filepath }).parseAsync(options.parsed);
72
+ return TeamAgent.from({
73
+ ...options.parsed,
74
+ ...valid,
75
+ reflection: valid.reflection && {
76
+ ...valid.reflection,
77
+ reviewer: await options.options.loadNestAgent(options.filepath, valid.reflection.reviewer, options.options),
78
+ },
79
+ });
80
+ }
50
81
  /**
51
82
  * Create a TeamAgent from the provided options.
52
83
  *
@@ -1,3 +1,4 @@
1
+ import { z } from "zod";
1
2
  import { Agent, type AgentOptions, type Message } from "./agent.js";
2
3
  /**
3
4
  * Configuration options for TransformAgent
@@ -47,6 +48,17 @@ export interface TransformAgentOptions<I extends Message, O extends Message> ext
47
48
  */
48
49
  export declare class TransformAgent<I extends Message = Message, O extends Message = Message> extends Agent<I, O> {
49
50
  static type: string;
51
+ static schema(): z.ZodObject<{
52
+ jsonata: z.ZodString;
53
+ }, "strip", z.ZodTypeAny, {
54
+ jsonata: string;
55
+ }, {
56
+ jsonata: string;
57
+ }>;
58
+ static load<I extends Message = any, O extends Message = any>(options: {
59
+ filepath: string;
60
+ parsed: object;
61
+ }): Promise<Agent<I, O>>;
50
62
  /**
51
63
  * Factory method to create a new TransformAgent instance
52
64
  *
@@ -1,4 +1,5 @@
1
1
  import jsonata from "jsonata";
2
+ import { z } from "zod";
2
3
  import { Agent } from "./agent.js";
3
4
  /**
4
5
  * TransformAgent - A specialized agent for data transformation using JSONata expressions
@@ -17,6 +18,18 @@ import { Agent } from "./agent.js";
17
18
  */
18
19
  export class TransformAgent extends Agent {
19
20
  static type = "TransformAgent";
21
+ static schema() {
22
+ return z.object({
23
+ jsonata: z.string(),
24
+ });
25
+ }
26
+ static async load(options) {
27
+ const parsed = await TransformAgent.schema().parseAsync(options.parsed);
28
+ return TransformAgent.from({
29
+ ...options.parsed,
30
+ ...parsed,
31
+ });
32
+ }
20
33
  /**
21
34
  * Factory method to create a new TransformAgent instance
22
35
  *
@@ -94,6 +94,7 @@ export declare const videoModelInputSchema: z.ZodObject<{
94
94
  prompt: string;
95
95
  model?: string | undefined;
96
96
  modelOptions?: Record<string, unknown> | undefined;
97
+ outputFileType?: "local" | "url" | "file" | undefined;
97
98
  image?: {
98
99
  type: "url";
99
100
  url: string;
@@ -110,13 +111,13 @@ export declare const videoModelInputSchema: z.ZodObject<{
110
111
  filename?: string | undefined;
111
112
  mimeType?: string | undefined;
112
113
  } | undefined;
113
- outputFileType?: "local" | "file" | "url" | undefined;
114
114
  size?: string | undefined;
115
115
  seconds?: string | undefined;
116
116
  }, {
117
117
  prompt: string;
118
118
  model?: string | undefined;
119
119
  modelOptions?: Record<string, unknown> | undefined;
120
+ outputFileType?: "local" | "url" | "file" | undefined;
120
121
  image?: {
121
122
  type: "url";
122
123
  url: string;
@@ -133,7 +134,6 @@ export declare const videoModelInputSchema: z.ZodObject<{
133
134
  filename?: string | undefined;
134
135
  mimeType?: string | undefined;
135
136
  } | undefined;
136
- outputFileType?: "local" | "file" | "url" | undefined;
137
137
  size?: string | undefined;
138
138
  seconds?: string | undefined;
139
139
  }>;
@@ -240,7 +240,6 @@ export declare const videoModelOutputSchema: z.ZodObject<{
240
240
  filename?: string | undefined;
241
241
  mimeType?: string | undefined;
242
242
  })[];
243
- model?: string | undefined;
244
243
  usage?: {
245
244
  inputTokens: number;
246
245
  outputTokens: number;
@@ -249,6 +248,7 @@ export declare const videoModelOutputSchema: z.ZodObject<{
249
248
  cacheReadInputTokens?: number | undefined;
250
249
  creditPrefix?: "$" | "€" | "¥" | undefined;
251
250
  } | undefined;
251
+ model?: string | undefined;
252
252
  seconds?: number | undefined;
253
253
  }, {
254
254
  videos: ({
@@ -267,7 +267,6 @@ export declare const videoModelOutputSchema: z.ZodObject<{
267
267
  filename?: string | undefined;
268
268
  mimeType?: string | undefined;
269
269
  })[];
270
- model?: string | undefined;
271
270
  usage?: {
272
271
  inputTokens: number;
273
272
  outputTokens: number;
@@ -276,5 +275,6 @@ export declare const videoModelOutputSchema: z.ZodObject<{
276
275
  cacheReadInputTokens?: number | undefined;
277
276
  creditPrefix?: "$" | "€" | "¥" | undefined;
278
277
  } | undefined;
278
+ model?: string | undefined;
279
279
  seconds?: number | undefined;
280
280
  }>;
@@ -159,7 +159,7 @@ export declare class AIGNEContext implements Context {
159
159
  readonly internal: AIGNEContextShared;
160
160
  get messageQueue(): MessageQueue;
161
161
  get model(): ChatModel | undefined;
162
- get imageModel(): ImageModel<import("../agents/image-model.js").ImageModelInput, import("../agents/image-model.js").ImageModelOutput> | undefined;
162
+ get imageModel(): ImageModel<import("../index.js").ImageModelInput, import("../index.js").ImageModelOutput> | undefined;
163
163
  get skills(): Agent<any, any>[] | undefined;
164
164
  get agents(): Agent<any, any>[];
165
165
  get observer(): AIGNEObserver | undefined;
@@ -197,7 +197,7 @@ declare class AIGNEContextShared {
197
197
  readonly messageQueue: MessageQueue;
198
198
  readonly events: Emitter<any>;
199
199
  get model(): ChatModel | undefined;
200
- get imageModel(): ImageModel<import("../agents/image-model.js").ImageModelInput, import("../agents/image-model.js").ImageModelOutput> | undefined;
200
+ get imageModel(): ImageModel<import("../index.js").ImageModelInput, import("../index.js").ImageModelOutput> | undefined;
201
201
  get skills(): Agent<any, any>[] | undefined;
202
202
  get agents(): Agent<any, any>[];
203
203
  get observer(): AIGNEObserver | undefined;
@@ -1,9 +1,6 @@
1
1
  import type { AFSOptions } from "@aigne/afs";
2
2
  import { type ZodType, z } from "zod";
3
- import type { AgentClass, AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
4
- import { AIAgentToolChoice } from "../agents/ai-agent.js";
5
- import { type Role } from "../agents/chat-model.js";
6
- import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
3
+ import type { AgentHooks, TaskRenderMode } from "../agents/agent.js";
7
4
  import type { LoadOptions } from "./index.js";
8
5
  import { chatModelSchema, imageModelSchema } from "./schema.js";
9
6
  export interface HooksSchema {
@@ -45,7 +42,8 @@ export interface AFSContextSchema {
45
42
  presets?: Record<string, AFSContextPresetSchema>;
46
43
  };
47
44
  }
48
- export interface BaseAgentSchema {
45
+ export interface AgentSchema {
46
+ type: string;
49
47
  name?: string;
50
48
  description?: string;
51
49
  model?: z.infer<typeof chatModelSchema>;
@@ -67,71 +65,11 @@ export interface BaseAgentSchema {
67
65
  context?: AFSContextSchema;
68
66
  });
69
67
  shareAFS?: boolean;
68
+ [key: string]: unknown;
70
69
  }
71
- export type Instructions = {
72
- role: Exclude<Role, "tool">;
73
- content: string;
74
- path: string;
75
- cacheControl?: {
76
- type: "ephemeral";
77
- ttl?: "5m" | "1h";
78
- };
79
- }[];
80
- export interface AIAgentSchema extends BaseAgentSchema {
81
- type: "ai";
82
- instructions?: Instructions;
83
- autoReorderSystemMessages?: boolean;
84
- autoMergeSystemMessages?: boolean;
85
- inputKey?: string;
86
- inputFileKey?: string;
87
- outputKey?: string;
88
- outputFileKey?: string;
89
- toolChoice?: AIAgentToolChoice;
90
- toolCallsConcurrency?: number;
91
- keepTextInToolUses?: boolean;
92
- }
93
- export interface ImageAgentSchema extends BaseAgentSchema {
94
- type: "image";
95
- instructions: Instructions;
96
- inputFileKey?: string;
97
- }
98
- export interface MCPAgentSchema extends BaseAgentSchema {
99
- type: "mcp";
100
- url?: string;
101
- command?: string;
102
- args?: string[];
103
- }
104
- export interface TeamAgentSchema extends BaseAgentSchema {
105
- type: "team";
106
- mode?: ProcessMode;
107
- iterateOn?: string;
108
- concurrency?: number;
109
- iterateWithPreviousOutput?: boolean;
110
- includeAllStepsOutput?: boolean;
111
- reflection?: Omit<ReflectionMode, "reviewer"> & {
112
- reviewer: NestAgentSchema;
113
- };
114
- }
115
- export interface TransformAgentSchema extends BaseAgentSchema {
116
- type: "transform";
117
- jsonata: string;
118
- }
119
- export interface FunctionAgentSchema extends BaseAgentSchema {
120
- type: "function";
121
- process: FunctionAgentFn;
122
- }
123
- export interface ThirdAgentSchema extends BaseAgentSchema {
124
- agentClass?: AgentClass;
125
- type: "";
126
- [key: string]: any;
127
- }
128
- export type AgentSchema = AIAgentSchema | ImageAgentSchema | MCPAgentSchema | TeamAgentSchema | TransformAgentSchema | FunctionAgentSchema | ThirdAgentSchema;
129
70
  export declare function parseAgentFile(path: string, data: any, options: LoadOptions): Promise<AgentSchema>;
130
71
  export declare function loadAgentFromYamlFile(path: string, options: LoadOptions): Promise<AgentSchema>;
131
- export declare const getInstructionsSchema: ({ filepath }: {
132
- filepath: string;
133
- }) => ZodType<Instructions>;
134
- export declare const getAgentSchema: ({ filepath, options, }: {
72
+ export declare const getAgentSchema: ({ filepath }: {
135
73
  filepath: string;
136
74
  options?: LoadOptions;
137
75
  }) => ZodType<AgentSchema, z.ZodTypeDef, AgentSchema>;
@@ -2,12 +2,8 @@ import { jsonSchemaToZod } from "@aigne/json-schema-to-zod";
2
2
  import { nodejs } from "@aigne/platform-helpers/nodejs/index.js";
3
3
  import { parse } from "yaml";
4
4
  import { z } from "zod";
5
- import { AIAgentToolChoice } from "../agents/ai-agent.js";
6
- import { roleSchema } from "../agents/chat-model.js";
7
- import { ProcessMode } from "../agents/team-agent.js";
8
5
  import { tryOrThrow } from "../utils/type-utils.js";
9
- import { codeToFunctionAgentFn } from "./function-agent.js";
10
- import { camelizeSchema, chatModelSchema, defaultInputSchema, imageModelSchema, inputOutputSchema, optionalize, preprocessSchema, } from "./schema.js";
6
+ import { camelizeSchema, chatModelSchema, defaultInputSchema, imageModelSchema, inputOutputSchema, optionalize, } from "./schema.js";
11
7
  export async function parseAgentFile(path, data, options) {
12
8
  const agentSchema = getAgentSchema({ filepath: path, options });
13
9
  return agentSchema.parseAsync({
@@ -25,51 +21,7 @@ export async function loadAgentFromYamlFile(path, options) {
25
21
  }, options), (error) => new Error(`Failed to validate agent definition from ${path}: ${error.message}`));
26
22
  return agent;
27
23
  }
28
- const instructionItemSchema = camelizeSchema(z.union([
29
- z.object({
30
- role: roleSchema.default("system"),
31
- url: z.string(),
32
- cacheControl: optionalize(z.object({
33
- type: z.literal("ephemeral"),
34
- ttl: optionalize(z.union([z.literal("5m"), z.literal("1h")])),
35
- })),
36
- }),
37
- z.object({
38
- role: roleSchema.default("system"),
39
- content: z.string(),
40
- cacheControl: optionalize(z.object({
41
- type: z.literal("ephemeral"),
42
- ttl: optionalize(z.union([z.literal("5m"), z.literal("1h")])),
43
- })),
44
- }),
45
- ]));
46
- const parseInstructionItem = ({ filepath }) => async ({ role, cacheControl, ...v }) => {
47
- if (role === "tool")
48
- throw new Error(`'tool' role is not allowed in instruction item in agent file ${filepath}`);
49
- if ("content" in v && typeof v.content === "string") {
50
- return { role, content: v.content, path: filepath, cacheControl };
51
- }
52
- if ("url" in v && typeof v.url === "string") {
53
- const url = nodejs.path.isAbsolute(v.url)
54
- ? v.url
55
- : nodejs.path.join(nodejs.path.dirname(filepath), v.url);
56
- return nodejs.fs
57
- .readFile(url, "utf8")
58
- .then((content) => ({ role, content, path: url, cacheControl }));
59
- }
60
- throw new Error(`Invalid instruction item in agent file ${filepath}. Expected 'content' or 'url' property`);
61
- };
62
- export const getInstructionsSchema = ({ filepath }) => z
63
- .union([z.string(), instructionItemSchema, z.array(instructionItemSchema)])
64
- .transform(async (v) => {
65
- if (typeof v === "string")
66
- return [{ role: "system", content: v, path: filepath }];
67
- if (Array.isArray(v)) {
68
- return Promise.all(v.map((item) => parseInstructionItem({ filepath })(item)));
69
- }
70
- return [await parseInstructionItem({ filepath })(v)];
71
- });
72
- export const getAgentSchema = ({ filepath, options, }) => {
24
+ export const getAgentSchema = ({ filepath }) => {
73
25
  const agentSchema = z.lazy(() => {
74
26
  const nestAgentSchema = z.lazy(() => z.union([
75
27
  agentSchema,
@@ -105,6 +57,7 @@ export const getAgentSchema = ({ filepath, options, }) => {
105
57
  }))),
106
58
  });
107
59
  const baseAgentSchema = z.object({
60
+ type: z.string(),
108
61
  name: optionalize(z.string()),
109
62
  alias: optionalize(z.array(z.string())),
110
63
  description: optionalize(z.string()),
@@ -143,94 +96,7 @@ export const getAgentSchema = ({ filepath, options, }) => {
143
96
  ])),
144
97
  shareAFS: optionalize(z.boolean()),
145
98
  });
146
- const instructionsSchema = getInstructionsSchema({ filepath: filepath });
147
- return camelizeSchema(preprocessSchema(async (json) => {
148
- if (typeof json === "object" &&
149
- json &&
150
- "type" in json &&
151
- typeof json.type === "string" &&
152
- !["ai", "image", "mcp", "team", "transform", "function"].includes(json.type)) {
153
- if (!options?.require)
154
- throw new Error(`Module loader is not provided to load agent type module ${json.type} from ${filepath}`);
155
- const Mod = await options.require(json.type, { parent: filepath });
156
- if (typeof Mod?.default?.prototype?.constructor !== "function") {
157
- throw new Error(`The agent type module ${json.type} does not export a default Agent class`);
158
- }
159
- Object.assign(json, { agentClass: Mod.default });
160
- }
161
- return json;
162
- }, z.union([
163
- z
164
- .object({
165
- type: z.string(),
166
- agentClass: z.custom((v) => typeof v?.prototype?.constructor === "function"),
167
- })
168
- .extend(baseAgentSchema.shape)
169
- .passthrough(),
170
- z.discriminatedUnion("type", [
171
- z
172
- .object({
173
- type: z.literal("ai"),
174
- instructions: optionalize(instructionsSchema),
175
- autoReorderSystemMessages: optionalize(z.boolean()),
176
- autoMergeSystemMessages: optionalize(z.boolean()),
177
- inputKey: optionalize(z.string()),
178
- outputKey: optionalize(z.string()),
179
- inputFileKey: optionalize(z.string()),
180
- outputFileKey: optionalize(z.string()),
181
- toolChoice: optionalize(z.nativeEnum(AIAgentToolChoice)),
182
- toolCallsConcurrency: optionalize(z.number().int().min(0)),
183
- keepTextInToolUses: optionalize(z.boolean()),
184
- catchToolsError: optionalize(z.boolean()),
185
- structuredStreamMode: optionalize(z.boolean()),
186
- })
187
- .extend(baseAgentSchema.shape),
188
- z
189
- .object({
190
- type: z.literal("image"),
191
- instructions: instructionsSchema,
192
- inputFileKey: optionalize(z.string()),
193
- })
194
- .extend(baseAgentSchema.shape),
195
- z
196
- .object({
197
- type: z.literal("mcp"),
198
- url: optionalize(z.string()),
199
- command: optionalize(z.string()),
200
- args: optionalize(z.array(z.string())),
201
- })
202
- .extend(baseAgentSchema.shape),
203
- z
204
- .object({
205
- type: z.literal("team"),
206
- mode: optionalize(z.nativeEnum(ProcessMode)),
207
- iterateOn: optionalize(z.string()),
208
- concurrency: optionalize(z.number().int().min(1)),
209
- iterateWithPreviousOutput: optionalize(z.boolean()),
210
- includeAllStepsOutput: optionalize(z.boolean()),
211
- reflection: camelizeSchema(optionalize(z.object({
212
- reviewer: nestAgentSchema,
213
- isApproved: z.string(),
214
- maxIterations: optionalize(z.number().int().min(1)),
215
- returnLastOnMaxIterations: optionalize(z.boolean()),
216
- customErrorMessage: optionalize(z.string()),
217
- }))),
218
- })
219
- .extend(baseAgentSchema.shape),
220
- z
221
- .object({
222
- type: z.literal("transform"),
223
- jsonata: z.string(),
224
- })
225
- .extend(baseAgentSchema.shape),
226
- z
227
- .object({
228
- type: z.literal("function"),
229
- process: z.preprocess((v) => (typeof v === "string" ? codeToFunctionAgentFn(v) : v), z.custom()),
230
- })
231
- .extend(baseAgentSchema.shape),
232
- ]),
233
- ])));
99
+ return camelizeSchema(baseAgentSchema.passthrough());
234
100
  });
235
101
  return agentSchema;
236
102
  };
@@ -0,0 +1,4 @@
1
+ import type { AgentClass } from "../agents/types.ts";
2
+ export declare const builtinAgents: {
3
+ [type: string]: AgentClass;
4
+ };
@@ -0,0 +1,14 @@
1
+ import { FunctionAgent } from "../agents/agent.js";
2
+ import { AIAgent } from "../agents/ai-agent.js";
3
+ import { ImageAgent } from "../agents/image-agent.js";
4
+ import { MCPAgent } from "../agents/mcp-agent.js";
5
+ import { TeamAgent } from "../agents/team-agent.js";
6
+ import { TransformAgent } from "../agents/transform-agent.js";
7
+ export const builtinAgents = {
8
+ ai: AIAgent,
9
+ function: FunctionAgent,
10
+ image: ImageAgent,
11
+ mcp: MCPAgent,
12
+ team: TeamAgent,
13
+ transform: TransformAgent,
14
+ };