@onco-foundry/agent-template 0.3.0 → 0.4.1

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 以内）。
@@ -151,7 +157,7 @@ export type AgentTemplate<I, O, C = undefined> = {
  * SDK submit_output 形态下模型交不出版本字段，且 agentTool 要求 outputSchema 与
  * target 声明一致。版本链走三处：capability.version（缺省 promptVersion）、
  * ToolDefinition.metadata（createTypedAgentTool 投射时写入）、createCapability
- * 返回能力的 describe()。这与 knowledge-gatekeeper（自定义 submit 工具把版本注入
+ * 返回能力的 describe()。这与 evidence-anchored-judgment（自定义 submit 工具把版本注入
  * payload）是两派实现，不要混用。
  *
  * options vs context 的分工：options（CreateTemplateAgentOptions）是静态装配——

package/dist/agent_template.js

@@ -33,7 +33,7 @@ const kebabCasePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
  * SDK submit_output 形态下模型交不出版本字段，且 agentTool 要求 outputSchema 与
  * target 声明一致。版本链走三处：capability.version（缺省 promptVersion）、
  * ToolDefinition.metadata（createTypedAgentTool 投射时写入）、createCapability
- * 返回能力的 describe()。这与 knowledge-gatekeeper（自定义 submit 工具把版本注入
+ * 返回能力的 describe()。这与 evidence-anchored-judgment（自定义 submit 工具把版本注入
  * payload）是两派实现，不要混用。
  *
  * options vs context 的分工：options（CreateTemplateAgentOptions）是静态装配——
@@ -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.1",
   "type": "module",
   "files": [
     "dist"
@@ -12,13 +12,13 @@
     }
   },
   "dependencies": {
-    "agent-lattice": "0.25.0",
+    "agent-lattice": "0.26.0",
     "zod": "^4.4.3",
-    "@onco-foundry/agent-runtime": "0.2.2",
-    "@onco-foundry/capability-registry": "0.1.1",
+    "@onco-foundry/agent-runtime": "0.3.0",
     "@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",
+    "@onco-foundry/trace-port": "0.3.3",
+    "@onco-foundry/resource-versioning": "0.3.0"
   },
   "publishConfig": {
     "access": "public"