@onco-foundry/agent-template 0.7.0 → 0.8.0

package/dist/agent_version.d.ts

@@ -6,6 +6,11 @@ import type { Tracer } from '@onco-foundry/trace-port';
 import type { AgentTemplateCard, TemplateToolDefinition } from './agent_template.ts';
 import type { ResolvedSkillPackage, SkillPackageReference, SkillPackageSummary } from './skill_packages.ts';
 export declare const agentResourceVersionSchema: z.ZodString;
+declare const resourceReferenceSchema: z.ZodObject<{
+    name: z.ZodString;
+    resource: z.ZodString;
+    version: z.ZodString;
+}, z.core.$strict>;
 export declare const agentVersionSchema: z.ZodObject<{
     schemaVersion: z.ZodEnum<{
         "agent-config-v1": "agent-config-v1";
@@ -48,6 +53,11 @@ export declare const agentVersionSchema: z.ZodObject<{
         id: z.ZodString;
         version: z.ZodString;
     }, z.core.$strict>>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        resource: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>>>;
     skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         version: z.ZodString;
@@ -65,6 +75,15 @@ export type AgentVersionPromptReference = AgentVersion['prompt'];
 export type AgentVersionCommonPromptReference = AgentVersion['commonPrompts'][number];
 export type AgentVersionToolReference = AgentVersion['tools'][number];
 export type AgentVersionMemberReference = AgentVersion['members'][number];
+export type AgentVersionResourceReference = z.infer<typeof resourceReferenceSchema>;
+export type ResolvedAgentResource = AgentVersionResourceReference & {
+    checksum: string;
+    files: ReadonlyMap<string, string>;
+};
+export type AgentResourceSnapshot = AgentVersionResourceReference & {
+    checksum: string;
+    files: Record<string, string>;
+};
 export type ResolvedAgentModel = AgentVersionModel & {
     apiKey?: string;
 };
@@ -82,6 +101,7 @@ export type ResolvedAgentVersion = {
     }>;
     tools: AgentVersionToolReference[];
     members: AgentVersionMemberReference[];
+    resources?: AgentResourceSnapshot[];
     skills?: SkillPackageSummary[];
     limits?: AgentVersion['limits'];
 };
@@ -111,6 +131,7 @@ export type ResolvedAgent = {
         version: string;
     };
     readSnapshot(): ResolvedAgentSnapshot;
+    readResources(): ResolvedAgentResource[];
     readSkills(): ResolvedSkillPackage[];
 };
 export type ResolvedAgentMember = {
@@ -124,6 +145,7 @@ export type AgentExecutorSpecInput<C> = {
     model: ResolvedAgentModel;
     systemPrompt: string;
     tools: TemplateToolDefinition[];
+    resources: ResolvedAgentResource[];
     members: ResolvedAgentMember[];
     context: C;
     skills?: ResolvedSkillPackage[];
@@ -151,6 +173,9 @@ export type AgentVersionPorts<C = unknown> = {
     readCommonPrompt(reference: AgentVersionCommonPromptReference, agentId: string): Promise<{
         content: string;
     }>;
+    readResource?(reference: AgentVersionResourceReference): Promise<{
+        files: ReadonlyMap<string, string>;
+    }>;
     createTool(reference: AgentVersionToolReference, context: C): TemplateToolDefinition | Promise<TemplateToolDefinition>;
     resolveExecutor(reference: AgentVersionExecutorReference): AgentVersionExecutor<C>;
     readSkill?(reference: SkillPackageReference): Promise<ResolvedSkillPackage>;
@@ -162,3 +187,4 @@ export type ResolveAgentVersionInput<C = unknown> = {
     promptVersion?: string;
     memberPromptVersions?: Record<string, string>;
 };
+export {};

package/dist/agent_version.js

@@ -26,6 +26,11 @@ const memberReferenceSchema = z.object({
     id: z.string().min(1),
     version: agentResourceVersionSchema,
 }).strict();
+const resourceReferenceSchema = z.object({
+    name: z.string().min(1),
+    resource: z.string().min(1),
+    version: agentResourceVersionSchema,
+}).strict();
 export const agentVersionSchema = z.object({
     schemaVersion: z.enum(['agent-config-v1', 'agent-config-v2']),
     executor: executorReferenceSchema,
@@ -41,6 +46,7 @@ export const agentVersionSchema = z.object({
     commonPrompts: z.array(commonPromptReferenceSchema),
     tools: z.array(localToolReferenceSchema),
     members: z.array(memberReferenceSchema),
+    resources: z.array(resourceReferenceSchema).refine(items => new Set(items.map(item => item.name)).size === items.length, '业务资源名称不能重复').optional(),
     skills: z.array(z.object({ id: z.string().regex(/^[a-z][a-z0-9-]{0,79}$/), version: agentResourceVersionSchema }).strict()).max(32).optional(),
     limits: z.object({
         maxTurns: z.number().int().positive().optional(),

package/dist/agent_version_resolver.js

@@ -39,6 +39,9 @@ export const createAgentVersionResolver = (ports) => {
                     prompt: { ...record.prompt },
                     systemPromptChecksum: record.systemPromptChecksum,
                     commonPrompts: record.commonPrompts.map(({ content: _content, ...part }) => ({ ...part })),
+                    ...(record.resources.length ? { resources: record.resources.map(({ files, ...reference }) => ({
+                            ...reference, files: Object.fromEntries([...files].map(([name, content]) => [name, checksum(content)])),
+                        })) } : {}),
                     tools: record.config.tools.map(tool => ({ ...tool })),
                     members: record.config.members.map(member => ({ ...member })),
                     ...(record.skills === undefined ? {} : { skills: record.skills.map(({ id, version, name, description, checksum }) => ({ id, version, name, description, checksum })) }),
@@ -118,6 +121,15 @@ export const createAgentVersionResolver = (ports) => {
                     const { content } = await ports.readCommonPrompt(reference, agentId);
                     return { ...reference, content, checksum: checksum(content) };
                 }));
+                const resources = await Promise.all((loaded.config.resources ?? []).map(async (reference) => {
+                    if (!ports.readResource)
+                        throw new AppError(`未配置业务资源读取端口：${reference.name}`);
+                    const resource = await ports.readResource(reference);
+                    const files = new Map([...resource.files].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0));
+                    if (!files.size)
+                        throw new AppError(`业务资源没有文件：${reference.resource}@${reference.version}`);
+                    return { ...reference, files, checksum: checksum(JSON.stringify([...files])) };
+                }));
                 const ordered = [...commonPrompts].sort((a, b) => a.placement === b.placement
                     ? a.order - b.order || a.id.localeCompare(b.id)
                     : a.placement === 'before' ? -1 : 1);
@@ -137,6 +149,7 @@ export const createAgentVersionResolver = (ports) => {
                     model: { ...loaded.config.model, ...modelCredential },
                     prompt: { ...promptReference, checksum: checksum(prompt.content) },
                     commonPrompts,
+                    resources,
                     systemPrompt,
                     systemPromptChecksum: checksum(systemPrompt),
                     ...(skills === undefined ? {} : { skills }),
@@ -156,6 +169,7 @@ export const createAgentVersionResolver = (ports) => {
                         systemPrompt: record.systemPrompt,
                         ...(record.skills === undefined ? {} : { skills: structuredClone(record.skills) }),
                         tools,
+                        resources: structuredClone(record.resources),
                         members: await Promise.all(record.config.members.map(async (member) => ({
                             id: member.id,
                             version: member.version,
@@ -192,6 +206,7 @@ export const createAgentVersionResolver = (ports) => {
                     },
                     readSystemPrompt: () => ({ content: record.systemPrompt, version: record.prompt.version }),
                     readSnapshot: () => structuredClone(snapshotFor(agentId)),
+                    readResources: () => structuredClone(record.resources),
                     readSkills: () => structuredClone(record.skills ?? []),
                 };
                 record.agent = agent;

package/dist/fake_agent_version_ports.d.ts

@@ -1,6 +1,6 @@
 import type { TemplateToolDefinition } from './agent_template.ts';
 import { type SkillPackageFiles, type SkillPackageReference } from './skill_packages.ts';
-import type { AgentVersion, AgentVersionCommonPromptReference, AgentVersionExecutor, AgentVersionPorts, AgentVersionPromptReference } from './agent_version.ts';
+import type { AgentVersion, AgentVersionCommonPromptReference, AgentVersionExecutor, AgentVersionPorts, AgentVersionPromptReference, AgentVersionResourceReference } from './agent_version.ts';
 export declare const createFakeAgentVersionPorts: <C>(options: {
     executors: Record<string, AgentVersionExecutor<C>>;
     modelApiKey?: string;
@@ -8,6 +8,7 @@ export declare const createFakeAgentVersionPorts: <C>(options: {
 }) => AgentVersionPorts<C> & {
     writeAgentVersion(agentId: string, version: string, config: AgentVersion, activate?: boolean): Promise<void>;
     activateAgentVersion(agentId: string, version: string): Promise<void>;
+    setResource(reference: AgentVersionResourceReference, files: Record<string, string>): void;
     setPrompt(reference: AgentVersionPromptReference, content: string): void;
     setCommonPrompt(reference: AgentVersionCommonPromptReference, content: string): void;
     writeSkill(reference: SkillPackageReference, files: SkillPackageFiles): Promise<void>;

package/dist/fake_agent_version_ports.js

@@ -9,6 +9,7 @@ export const createFakeAgentVersionPorts = (options) => {
     const stores = new Map();
     const prompts = new Map();
     const commonPrompts = new Map();
+    const resources = new Map();
     const skillStores = new Map();
     const skills = createSkillPackages({ storeFor: id => {
             if (!skillStores.has(id))
@@ -39,6 +40,13 @@ export const createFakeAgentVersionPorts = (options) => {
                 throw new AppError(`fake 共同 prompt 不存在：${commonPromptKey(reference)}`);
             return { content };
         },
+        readResource: async (reference) => {
+            const files = resources.get(promptKey(reference));
+            if (!files)
+                throw new AppError(`fake 业务资源不存在：${promptKey(reference)}`);
+            return { files: new Map(Object.entries(files)) };
+        },
+        setResource(reference, files) { resources.set(promptKey(reference), { ...files }); },
         createTool(reference, context) {
             const create = options.tools?.[toolKey(reference)];
             if (create === undefined)

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { clampThinkingBudgetTokens, defineAgentTemplate, promptManifestSchema, type AgentTemplate, type AgentTemplateCard, type AgentTemplateDeclaration, type CreateTemplateAgentOptions, type PromptManifestAdapter, type TemplateToolDefinition, } from './agent_template.ts';
 export type { CapabilityDelegation } from '@onco-foundry/agent-runtime';
 export { createAgentSpecExecutor, type AgentSpecExecutorDeclaration } from './agent_spec_executor.ts';
-export { agentResourceVersionSchema, agentVersionSchema, type AgentVersion, type AgentVersionCommonPromptReference, type AgentVersionExecutor, type AgentVersionExecutorReference, type AgentVersionMemberReference, type AgentVersionModel, type AgentVersionPorts, type AgentVersionPromptReference, type AgentVersionToolReference, type CreateResolvedAgentSpecOptions, type ResolveAgentVersionInput, type ResolvedAgent, type ResolvedAgentMember, type ResolvedAgentModel, type ResolvedAgentSnapshot, type ResolvedAgentVersion, } from './agent_version.ts';
+export { agentResourceVersionSchema, agentVersionSchema, type AgentVersion, type AgentVersionResourceReference, type AgentResourceSnapshot, type ResolvedAgentResource, type AgentVersionCommonPromptReference, type AgentVersionExecutor, type AgentVersionExecutorReference, type AgentVersionMemberReference, type AgentVersionModel, type AgentVersionPorts, type AgentVersionPromptReference, type AgentVersionToolReference, type CreateResolvedAgentSpecOptions, type ResolveAgentVersionInput, type ResolvedAgent, type ResolvedAgentMember, type ResolvedAgentModel, type ResolvedAgentSnapshot, type ResolvedAgentVersion, } from './agent_version.ts';
 export { createAgentVersionResolver } from './agent_version_resolver.ts';
 export { createFakeAgentVersionPorts } from './fake_agent_version_ports.ts';
 export { createSkillPackages, type SkillPackageFiles, type SkillPackageReference, type SkillPackageSummary, type ResolvedSkillPackage } from './skill_packages.ts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onco-foundry/agent-template",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "type": "module",
   "files": [
     "dist"
@@ -16,10 +16,10 @@
     "yaml": "^2.9.1",
     "zod": "^4.4.3",
     "@onco-foundry/agent-runtime": "0.3.0",
-    "@onco-foundry/errors": "0.1.1",
-    "@onco-foundry/capability-registry": "0.1.1",
+    "@onco-foundry/trace-port": "0.3.3",
     "@onco-foundry/resource-versioning": "0.3.0",
-    "@onco-foundry/trace-port": "0.3.3"
+    "@onco-foundry/errors": "0.1.1",
+    "@onco-foundry/capability-registry": "0.1.1"
   },
   "publishConfig": {
     "access": "public"