@onco-foundry/agent-template 0.2.2 → 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 以内）。
@@ -104,6 +110,14 @@ export type CreateTemplateAgentOptions = {
     tracer?: Tracer;
     /** prompt 版本覆盖缝：指定版本目录名则跳过 current.json 指针，试跑/对照工具用。 */
     promptVersion?: string;
+    /**
+     * submit_output 提交后是否结束运行（agent-lattice 0.25.0 的 submitOutputEndTurn，仅 outputSchema 形态有意义）。
+     * 缺省不传 = SDK 默认 true：提交即收尾，委派链路与直接 run 的有界交付不变。
+     * 仅 human-facing 调试会话（playground）显式传 false：模型交付后继续用人话总结收尾。
+     * false 形态下 generic run 照样取 response.structuredResult（SDK 保证最后一次提交进 structuredResult）；
+     * 委派链路不该传 false——委派要的是有界交付，不是继续闲聊。
+     */
+    readonly submitOutputEndTurn?: boolean;
 };
 export type AgentTemplate<I, O, C = undefined> = {
     /** 能力名片：{ name: id, kind: 'agent', summary, input, output }，无 version（版本归场景，ADR-10）。 */

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 }
@@ -109,6 +123,10 @@ export const defineAgentTemplate = (declaration) => {
             // 无领域校验要过，交付契约直接交给 SDK：声明 outputSchema 后 SDK 注入
             // submit_output 工具，没提交就收尾会以 error_missing_output 失败。
             outputSchema: declaration.output,
+            // submit_output 提交后是否结束运行：没给就不设该字段，SDK 默认 true（提交即收尾）。
+            ...(options.submitOutputEndTurn === undefined
+                ? {}
+                : { submitOutputEndTurn: options.submitOutputEndTurn }),
             // 业务工具槽位：声明了才构建，依赖经 context 在创建时绑定；与 submit_output 并存。
             ...(declaration.tools === undefined ? {} : { tools: declaration.tools(context) }),
             tracer,

package/package.json

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