@onco-foundry/agent-template 0.3.0 → 0.4.0

package/dist/agent_template.d.ts

@@ -2,7 +2,7 @@ import { type AgentSpec, type ModelClient, type ToolDefinition } from 'agent-lat
 import { z } from 'zod';
 import { type Capability } from '@onco-foundry/capability-registry';
 import type { CapabilityDelegation } from '@onco-foundry/agent-runtime';
-import { type VersionedResource } from '@onco-foundry/resource-versioning';
+import { type VersionedResource, type VersionedResourceStore } from '@onco-foundry/resource-versioning';
 import { type Tracer } from '@onco-foundry/trace-port';
 /**
  * 版本化 prompt 资源的 manifest 形状：结构版本号与内容版本号分开，
@@ -80,8 +80,14 @@ export type AgentTemplateDeclaration<I, O, C = undefined> = {
     /**
      * 版本化 prompt 资源根（含 current.json 指针）：
      * new URL('./resources/prompts/', import.meta.url)。生效版本解析归模板，编排方零感知。
+     * 与 promptStore 二选一。
      */
-    promptDir: URL;
+    promptDir?: URL;
+    /**
+     * prompt 资源存储后端：资源不在文件系统（如 MySQL）时注入，与 promptDir 二选一。
+     * 生效版本解析与 sha256 完整性校验不变，仍归模板。
+     */
+    promptStore?: VersionedResourceStore;
     /**
      * 可选限额。缺省：maxTokens 16384、maxTurns 10、thinking 关闭；
      * thinkingBudgetTokens 给了才开 thinking（按 clampThinkingBudgetTokens 钳制到 maxTokens 以内）。

package/dist/agent_template.js

@@ -48,6 +48,20 @@ export const defineAgentTemplate = (declaration) => {
         throw new AppError(`模板 id 必须是 kebab-case（小写字母数字与连字符）：${declaration.id}`);
     }
     const { id } = declaration;
+    /**
+     * prompt 来源在 loadPrompt 时才解析：声明对象允许在定义后补齐 promptDir/promptStore
+     * （测试夹具在 beforeAll 里指向临时资源就是这种用法），但同一时刻二者只能有一个。
+     */
+    const resolvePromptSource = () => {
+        if (declaration.promptDir !== undefined && declaration.promptStore !== undefined) {
+            throw new AppError(`模板 ${id} 的 promptDir 与 promptStore 只能二选一`);
+        }
+        if (declaration.promptStore !== undefined)
+            return { store: declaration.promptStore };
+        if (declaration.promptDir !== undefined)
+            return { baseDir: declaration.promptDir };
+        throw new AppError(`模板 ${id} 必须声明 promptDir 或 promptStore 之一（prompt 资源在哪里，模板必须知道）`);
+    };
     const card = {
         name: id,
         kind: 'agent',
@@ -70,7 +84,7 @@ export const defineAgentTemplate = (declaration) => {
     const loadPrompt = async (loadOptions) => {
         const adapter = declaration.promptManifest ?? defaultPromptManifest;
         const promptResource = await loadActiveVersionedResource({
-            baseDir: declaration.promptDir,
+            ...resolvePromptSource(),
             manifestSchema: adapter.manifestSchema,
             ...(loadOptions?.promptVersion !== undefined
                 ? { versionOverride: loadOptions.promptVersion }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onco-foundry/agent-template",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "files": [
     "dist"
@@ -14,11 +14,11 @@
   "dependencies": {
     "agent-lattice": "0.25.0",
     "zod": "^4.4.3",
+    "@onco-foundry/resource-versioning": "0.3.0",
     "@onco-foundry/agent-runtime": "0.2.2",
-    "@onco-foundry/capability-registry": "0.1.1",
+    "@onco-foundry/trace-port": "0.3.2",
     "@onco-foundry/errors": "0.1.1",
-    "@onco-foundry/resource-versioning": "0.2.0",
-    "@onco-foundry/trace-port": "0.3.2"
+    "@onco-foundry/capability-registry": "0.1.1"
   },
   "publishConfig": {
     "access": "public"