@siming-org/server 0.3.0 → 0.4.0

package/dist/{chunk-T7QAGG73.js → chunk-XVFWTF42.js}

@@ -235,7 +235,10 @@ import {
   SkillCreateSchema,
   SkillUpdateSchema,
   SkillCopySchema,
+  AssetSetEnabledSchema,
   OBJECT_ID_HEX,
+  assertReferencesDeletable,
+  assertReferenceAggregateLimit,
   NotFoundError as NotFoundError2,
   ConflictError as ConflictError2,
   BadRequestError,
@@ -243,19 +246,26 @@ import {
 } from "@siming-org/core";
 var SkillListQuerySchema = z.object({
   projectId: z.string().optional(),
-  scope: z.enum(["global", "project"]).optional()
+  scope: z.enum(["global", "project"]).optional(),
+  q: z.string().trim().min(1).max(100).optional(),
+  includeDisabled: z.stringbool().optional()
 }).refine((q) => !(q.scope === "project" && !q.projectId), {
   message: "scope=project requires projectId",
   path: ["projectId"]
 });
 var SkillByNameQuerySchema = z.object({
   scope: z.enum(["global", "project"]).optional(),
-  projectId: z.string().regex(OBJECT_ID_HEX).optional()
+  projectId: z.string().regex(OBJECT_ID_HEX).optional(),
+  includeDisabled: z.stringbool().optional()
 }).superRefine((q, ctx) => {
   if (q.scope === "project" && !q.projectId) {
     ctx.addIssue({ code: z.ZodIssueCode.custom, message: "scope=project requires projectId", path: ["projectId"] });
   }
 });
+function skillToListItem(skill) {
+  const { references, ...rest } = skill;
+  return { ...rest, referenceCount: references?.length ?? 0 };
+}
 function createSkillRoutes(client) {
   const app = new Hono4();
   const repo = createSkillRepo(client.db());
@@ -272,15 +282,18 @@ function createSkillRoutes(client) {
   };
   app.get("/api/skills", zValidator2("query", SkillListQuerySchema), async (c) => {
     const q = c.req.valid("query");
+    const opts = { includeDisabled: q.includeDisabled, q: q.q };
     if (q.scope) {
-      return c.json(await repo.listSkillsByScopeFilter(q.scope, q.projectId));
+      return c.json((await repo.listSkillsByScopeFilter(q.scope, q.projectId, opts)).map(skillToListItem));
     }
-    return c.json(q.projectId ? await repo.listSkillsByScope(q.projectId) : await repo.list());
+    return c.json(
+      (q.projectId ? await repo.listSkillsByScope(q.projectId, opts) : await repo.listSkills(opts)).map(skillToListItem)
+    );
   });
   app.get("/api/skills/:name", zValidator2("query", SkillByNameQuerySchema), async (c) => {
     const name = c.req.param("name");
     const q = c.req.valid("query");
-    const skill = await resolveAssetByScope(repo, name, q);
+    const skill = await resolveAssetByScope(repo, name, q, { includeDisabled: q.includeDisabled });
     if (!skill) throw new NotFoundError2("skill", name);
     return c.json(skill);
   });
@@ -294,7 +307,7 @@ function createSkillRoutes(client) {
     const name = c.req.param("name");
     const data = c.req.valid("json");
     const q = c.req.valid("query");
-    const existing = await resolveAssetByScope(repo, name, q);
+    const existing = await resolveAssetByScope(repo, name, q, { includeDisabled: true });
     if (!existing) throw new NotFoundError2("skill", name);
     if (data.category !== void 0) await assertCategoryValid(data.category);
     if (isScopeMutation(existing, data)) {
@@ -307,6 +320,18 @@ function createSkillRoutes(client) {
     if ((data.scope ?? existing.scope) === "project" && effectiveProjectId) {
       await loadProjectForWrite(projectRepo, effectiveProjectId);
     }
+    assertReferencesDeletable({
+      resource: "skill",
+      name,
+      existingReferences: existing.references,
+      nextReferences: data.references,
+      nextMainBody: data.content,
+      currentMainBody: existing.content
+    });
+    assertReferenceAggregateLimit({
+      effectiveMainBody: data.content ?? existing.content,
+      nextReferences: data.references
+    });
     const skill = await repo.updateByNameScoped(name, q.scope ?? "global", q.projectId, data);
     if (!skill) throw new NotFoundError2("skill", name);
     return c.json(skill);
@@ -315,7 +340,7 @@ function createSkillRoutes(client) {
     const name = c.req.param("name");
     const input = c.req.valid("json");
     const q = c.req.valid("query");
-    const existing = await resolveAssetByScope(repo, name, q);
+    const existing = await resolveAssetByScope(repo, name, q, { includeDisabled: true });
     if (!existing) throw new NotFoundError2("skill", name);
     if (input.newScope === "project") {
       await loadProjectForWrite(projectRepo, input.targetProjectId);
@@ -331,12 +356,26 @@ function createSkillRoutes(client) {
   app.delete("/api/skills/:name", zValidator2("query", SkillByNameQuerySchema), async (c) => {
     const name = c.req.param("name");
     const q = c.req.valid("query");
-    const existing = await resolveAssetByScope(repo, name, q);
+    const existing = await resolveAssetByScope(repo, name, q, { includeDisabled: true });
     if (!existing) throw new NotFoundError2("skill", name);
     const deleted = await repo.deleteByNameScoped(name, q.scope ?? "global", q.projectId);
     if (!deleted) throw new NotFoundError2("skill", name);
     return c.body(null, 204);
   });
+  app.post("/api/skills/:name/enabled", zValidator2("query", SkillByNameQuerySchema), zValidator2("json", AssetSetEnabledSchema), async (c) => {
+    const name = c.req.param("name");
+    const body = c.req.valid("json");
+    const q = c.req.valid("query");
+    const existing = await resolveAssetByScope(repo, name, q, { includeDisabled: true });
+    if (!existing) throw new NotFoundError2("skill", name);
+    const scope = q.scope ?? "global";
+    if (scope === "project") {
+      await loadProjectForWrite(projectRepo, existing.projectId ?? q.projectId);
+    }
+    const skill = await repo.updateByNameScoped(name, scope, q.projectId, { enabled: body.enabled });
+    if (!skill) throw new NotFoundError2("skill", name);
+    return c.json({ name: skill.name, enabled: skill.enabled ?? true });
+  });
   return app;
 }
 function isScopeMutation(existing, patch) {
@@ -344,8 +383,8 @@ function isScopeMutation(existing, patch) {
   if (patch.projectId !== void 0 && patch.projectId !== existing.projectId) return true;
   return false;
 }
-async function resolveAssetByScope(repo, name, q) {
-  return repo.getByNameScoped(name, q.scope ?? "global", q.projectId);
+async function resolveAssetByScope(repo, name, q, opts) {
+  return repo.getByNameScoped(name, q.scope ?? "global", q.projectId, opts);
 }
 
 // src/routes/agent.routes.ts
@@ -353,6 +392,7 @@ import { Hono as Hono5 } from "hono";
 import { zValidator as zValidator3 } from "@hono/zod-validator";
 import { z as z2 } from "zod";
 import {
+  bumpPatch,
   createAgentRepo,
   createSkillRepo as createSkillRepo2,
   createProjectRepo as createProjectRepo3,
@@ -360,15 +400,24 @@ import {
   AgentCreateSchema,
   AgentUpdateSchema,
   AgentCopySchema,
+  AssetSetEnabledSchema as AssetSetEnabledSchema2,
+  assertReferencesDeletable as assertReferencesDeletable2,
+  assertReferenceAggregateLimit as assertReferenceAggregateLimit2,
   NotFoundError as NotFoundError3,
   ConflictError as ConflictError3,
   BIZ_CODE_MESSAGES as BIZ_CODE_MESSAGES3,
   assertBoundSkillsCompatible,
   assertModelAliasExists
 } from "@siming-org/core";
+function agentToListItem(agent) {
+  const { references, ...rest } = agent;
+  return { ...rest, referenceCount: references?.length ?? 0 };
+}
 var AgentListQuerySchema = z2.object({
   projectId: z2.string().optional(),
-  scope: z2.enum(["global", "project"]).optional()
+  scope: z2.enum(["global", "project"]).optional(),
+  q: z2.string().trim().min(1).max(100).optional(),
+  includeDisabled: z2.stringbool().optional()
 }).refine((q) => !(q.scope === "project" && !q.projectId), {
   message: "scope=project requires projectId",
   path: ["projectId"]
@@ -381,15 +430,18 @@ function createAgentRoutes(client) {
   const aliasRepo = createModelAliasRepo(client.db());
   app.get("/api/agents", zValidator3("query", AgentListQuerySchema), async (c) => {
     const q = c.req.valid("query");
+    const opts = { includeDisabled: q.includeDisabled, q: q.q };
     if (q.scope) {
-      return c.json(await repo.listAgentsByScopeFilter(q.scope, q.projectId));
+      return c.json((await repo.listAgentsByScopeFilter(q.scope, q.projectId, opts)).map(agentToListItem));
     }
-    return c.json(q.projectId ? await repo.listAgentsByScope(q.projectId) : await repo.list());
+    return c.json(
+      (q.projectId ? await repo.listAgentsByScope(q.projectId, opts) : await repo.listAgents(opts)).map(agentToListItem)
+    );
   });
   app.get("/api/agents/:name", zValidator3("query", SkillByNameQuerySchema), async (c) => {
     const name = c.req.param("name");
     const q = c.req.valid("query");
-    const agent = await resolveAssetByScope(repo, name, q);
+    const agent = await resolveAssetByScope(repo, name, q, { includeDisabled: q.includeDisabled });
     if (!agent) throw new NotFoundError3("agent", name);
     return c.json(agent);
   });
@@ -404,8 +456,12 @@ function createAgentRoutes(client) {
     const name = c.req.param("name");
     const data = c.req.valid("json");
     const q = c.req.valid("query");
-    const existing = await resolveAssetByScope(repo, name, q);
+    const existing = await resolveAssetByScope(repo, name, q, { includeDisabled: true });
     if (!existing) throw new NotFoundError3("agent", name);
+    let payload = data;
+    if (data["function"] !== void 0 && data["function"] !== existing["function"]) {
+      payload = { ...data, version: bumpPatch(data.version ?? existing.version) };
+    }
     if (isScopeMutation(existing, data)) {
       throw new ConflictError3("agent", name, {
         bizCode: "SCOPE_IMMUTABLE",
@@ -427,7 +483,19 @@ function createAgentRoutes(client) {
     if (data.model !== void 0) {
       await assertModelAliasExists(aliasRepo, data.model);
     }
-    const agent = await repo.updateByNameScoped(name, q.scope ?? "global", q.projectId, data);
+    assertReferencesDeletable2({
+      resource: "agent",
+      name,
+      existingReferences: existing.references,
+      nextReferences: data.references,
+      nextMainBody: data.systemPrompt,
+      currentMainBody: existing.systemPrompt
+    });
+    assertReferenceAggregateLimit2({
+      effectiveMainBody: data.systemPrompt ?? existing.systemPrompt,
+      nextReferences: data.references
+    });
+    const agent = await repo.updateByNameScoped(name, q.scope ?? "global", q.projectId, payload);
     if (!agent) throw new NotFoundError3("agent", name);
     return c.json(agent);
   });
@@ -435,7 +503,7 @@ function createAgentRoutes(client) {
     const name = c.req.param("name");
     const input = c.req.valid("json");
     const q = c.req.valid("query");
-    const existing = await resolveAssetByScope(repo, name, q);
+    const existing = await resolveAssetByScope(repo, name, q, { includeDisabled: true });
     if (!existing) throw new NotFoundError3("agent", name);
     if (input.newScope === "project") {
       await loadProjectForWrite(projectRepo, input.targetProjectId);
@@ -452,12 +520,26 @@ function createAgentRoutes(client) {
   app.delete("/api/agents/:name", zValidator3("query", SkillByNameQuerySchema), async (c) => {
     const name = c.req.param("name");
     const q = c.req.valid("query");
-    const existing = await resolveAssetByScope(repo, name, q);
+    const existing = await resolveAssetByScope(repo, name, q, { includeDisabled: true });
     if (!existing) throw new NotFoundError3("agent", name);
     const deleted = await repo.deleteByNameScoped(name, q.scope ?? "global", q.projectId);
     if (!deleted) throw new NotFoundError3("agent", name);
     return c.body(null, 204);
   });
+  app.post("/api/agents/:name/enabled", zValidator3("query", SkillByNameQuerySchema), zValidator3("json", AssetSetEnabledSchema2), async (c) => {
+    const name = c.req.param("name");
+    const body = c.req.valid("json");
+    const q = c.req.valid("query");
+    const existing = await resolveAssetByScope(repo, name, q, { includeDisabled: true });
+    if (!existing) throw new NotFoundError3("agent", name);
+    const scope = q.scope ?? "global";
+    if (scope === "project") {
+      await loadProjectForWrite(projectRepo, existing.projectId ?? q.projectId);
+    }
+    const agent = await repo.updateByNameScoped(name, scope, q.projectId, { enabled: body.enabled });
+    if (!agent) throw new NotFoundError3("agent", name);
+    return c.json({ name: agent.name, enabled: agent.enabled ?? true });
+  });
   return app;
 }
 
@@ -523,27 +605,44 @@ import { z as z3 } from "zod";
 import {
   createDagTemplateRepo,
   createProjectRepo as createProjectRepo4,
+  createSkillRepo as createSkillRepo3,
+  createAgentRepo as createAgentRepo2,
+  createModelAliasRepo as createModelAliasRepo3,
   DagTemplateCreateSchema,
   DagTemplateCopySchema,
   DagTemplateUpdateSchema,
+  AssetSetEnabledSchema as AssetSetEnabledSchema3,
+  ImportPlanRequestSchema,
+  ImportApplyRequestSchema,
+  composeExportBundle,
+  buildImportPlan,
+  applyImport,
   NotFoundError as NotFoundError5,
   ConflictError as ConflictError5,
   BIZ_CODE_MESSAGES as BIZ_CODE_MESSAGES5
 } from "@siming-org/core";
 var DagTemplateListQuerySchema = z3.object({
   projectId: z3.string().optional(),
-  name: z3.string().optional()
+  name: z3.string().optional(),
+  includeDisabled: z3.stringbool().optional()
 });
 function createDagTemplateRoutes(client) {
   const app = new Hono7();
   const repo = createDagTemplateRepo(client.db());
   const projectRepo = createProjectRepo4(client.db());
+  const transferDeps = {
+    templateRepo: repo,
+    skillRepo: createSkillRepo3(client.db()),
+    agentRepo: createAgentRepo2(client.db()),
+    modelAliasRepo: createModelAliasRepo3(client.db())
+  };
   app.get("/api/dag/templates", zValidator5("query", DagTemplateListQuerySchema), async (c) => {
     const q = c.req.valid("query");
     return c.json(
       await repo.listDagTemplates({
         ...q.projectId ? { projectId: q.projectId } : {},
-        ...q.name ? { name: q.name } : {}
+        ...q.name ? { name: q.name } : {},
+        ...q.includeDisabled !== void 0 ? { includeDisabled: q.includeDisabled } : {}
       })
     );
   });
@@ -553,6 +652,16 @@ function createDagTemplateRoutes(client) {
     if (!template) throw new NotFoundError5("dag-template", id);
     return c.json(template);
   });
+  app.post("/api/dag/templates/:id/enabled", zValidator5("json", AssetSetEnabledSchema3), async (c) => {
+    const id = c.req.param("id");
+    const body = c.req.valid("json");
+    const existing = await repo.getById(id);
+    if (!existing) throw new NotFoundError5("dag-template", id);
+    await loadProjectForWrite(projectRepo, existing.projectId);
+    const template = await repo.update(id, { enabled: body.enabled });
+    if (!template) throw new NotFoundError5("dag-template", id);
+    return c.json({ id: template.id, name: template.name, enabled: template.enabled ?? true });
+  });
   app.post("/api/dag/templates", zValidator5("json", DagTemplateCreateSchema), async (c) => {
     const data = c.req.valid("json");
     await loadProjectForWrite(projectRepo, data.projectId);
@@ -605,6 +714,20 @@ function createDagTemplateRoutes(client) {
     const copy = await repo.copyDagTemplate(id, input.targetProjectId, input.newName);
     return c.json(copy, 201);
   });
+  app.get("/api/dag/templates/:id/export", async (c) => {
+    const id = c.req.param("id");
+    return c.json(await composeExportBundle(transferDeps, id));
+  });
+  app.post("/api/dag/templates/import/plan", zValidator5("json", ImportPlanRequestSchema), async (c) => {
+    const body = c.req.valid("json");
+    await loadProjectForWrite(projectRepo, body.targetProjectId);
+    return c.json(await buildImportPlan(transferDeps, body.targetProjectId, body.bundle));
+  });
+  app.post("/api/dag/templates/import/apply", zValidator5("json", ImportApplyRequestSchema), async (c) => {
+    const body = c.req.valid("json");
+    await loadProjectForWrite(projectRepo, body.targetProjectId);
+    return c.json(await applyImport(transferDeps, body.targetProjectId, body.bundle, body.decisions));
+  });
   app.delete("/api/dag/templates/:id", async (c) => {
     const id = c.req.param("id");
     const deleted = await repo.delete(id);
@@ -627,6 +750,11 @@ import {
   ApproveRequestSchema,
   PauseRequestSchema,
   ResumeRequestSchema,
+  CancelRequestSchema,
+  taskProgress,
+  excerpt,
+  ContextViewSchema,
+  CONTEXT_VIEWS,
   ARTIFACT_TYPES,
   NODE_ID_PATTERN,
   createEnumRegistryRepo as createEnumRegistryRepo2,
@@ -639,6 +767,7 @@ import {
   approveTask,
   pauseTask,
   resumeTask,
+  cancelTask,
   renderPrompt,
   toNodeInfo,
   toTaskPublic,
@@ -649,6 +778,7 @@ var TaskListQuerySchema = z4.object({
   status: z4.string().optional(),
   track: z4.string().optional(),
   projectId: z4.string().optional(),
+  q: z4.string().trim().min(1).max(100).optional(),
   page: z4.coerce.number().int().min(1).default(1),
   limit: z4.coerce.number().int().min(1).max(500).default(20),
   sort: z4.enum(["progress", "createdAt", "updatedAt"]).optional()
@@ -701,6 +831,30 @@ function normalizeNodeRecords(records) {
   }
   return out;
 }
+function stripArtifactContent(records) {
+  const out = {};
+  for (const [nodeId, record] of Object.entries(records)) {
+    out[nodeId] = {
+      ...record,
+      artifacts: record.artifacts.map((a) => {
+        if (a.content === void 0) return a;
+        const { content: _stripped, ...rest } = a;
+        return rest;
+      })
+    };
+  }
+  return out;
+}
+function writeAck(entity, updated, entry, echo) {
+  return {
+    taskId: entity.taskId,
+    updated,
+    ...entry !== void 0 ? { entry } : {},
+    ...echo !== void 0 ? { echo } : {},
+    updatedAt: entity.updatedAt ?? /* @__PURE__ */ new Date(),
+    task: { ...toTaskPublic(entity), projectId: entity.projectId, progress: taskProgress(entity) }
+  };
+}
 function createTaskRoutes(client) {
   const app = new Hono8();
   const repo = createTaskRepo(client.db());
@@ -713,6 +867,7 @@ function createTaskRoutes(client) {
       ...q.status ? { status: q.status } : {},
       ...q.track ? { track: q.track } : {},
       ...q.projectId ? { projectId: q.projectId } : {},
+      ...q.q !== void 0 ? { q: q.q } : {},
       page: q.page,
       limit: q.limit,
       ...q.sort ? { sort: q.sort } : {}
@@ -739,6 +894,12 @@ function createTaskRoutes(client) {
     assertTypeTrackCompatible(input.type, input.track);
     const template = await templateRepo.getById(input.dagTemplateId);
     if (!template) throw new NotFoundError6("dag-template", input.dagTemplateId);
+    if (template.enabled === false) {
+      throw new ConflictError6("task", input.dagTemplateId, {
+        bizCode: "TEMPLATE_DISABLED",
+        message: BIZ_CODE_MESSAGES6.TEMPLATE_DISABLED
+      });
+    }
     if (input.projectId && input.projectId !== template.projectId) {
       throw new ConflictError6("task", input.dagTemplateId, {
         bizCode: "TEMPLATE_PROJECT_MISMATCH",
@@ -747,16 +908,33 @@ function createTaskRoutes(client) {
     }
     const resolvedProjectId = input.projectId ?? template.projectId;
     await loadProjectForWrite(projectRepo, resolvedProjectId);
-    return c.json(await repo.createTask(input, template, resolvedProjectId), 201);
+    const created = await repo.createTask(input, template, resolvedProjectId);
+    const firstActive = created.dagInstance.nodes.find(
+      (n) => created.dagInstance.nodeStates[n.id]?.status === "active"
+    );
+    if (!firstActive) {
+      throw new BadRequestError2(
+        `task has no active node to start (all nodes pruned by skipNodes); \u6A21\u677F ${template.name} \u526A\u679D\u540E\u65E0\u53EF\u5F00\u5DE5\u8282\u70B9\uFF0C\u521B\u5EFA\u88AB\u62D2\u7EDD`
+      );
+    }
+    const response = {
+      task: { ...toTaskPublic(created), projectId: created.projectId, progress: taskProgress(created) },
+      firstNode: toNodeInfo(firstActive, created)
+    };
+    return c.json(response, 201);
   });
   app.patch("/api/tasks/:taskId", zValidator6("json", TaskPatchSchema), async (c) => {
     const taskId = c.req.param("taskId");
     const body = c.req.valid("json");
+    if (body.title === void 0) {
+      throw new BadRequestError2("PATCH /api/tasks/:taskId \u9700\u8981\u81F3\u5C11\u4E00\u4E2A\u53EF\u66F4\u65B0\u5B57\u6BB5\uFF08title\uFF09");
+    }
     await assertTaskProjectActive(repo, projectRepo, taskId);
-    const patch = {
-      ...body.title !== void 0 ? { title: body.title } : {}
-    };
-    return c.json(await repo.updateTask(taskId, patch));
+    const patch = { title: body.title };
+    const updatedTask = await repo.updateTask(taskId, patch);
+    return c.json(
+      writeAck(updatedTask, ["title"], void 0, [{ path: "title", excerpt: excerpt(updatedTask.title) }])
+    );
   });
   app.post("/api/tasks/:taskId/advance", zValidator6("json", AdvanceRequestSchema), async (c) => {
     const taskId = c.req.param("taskId");
@@ -782,14 +960,31 @@ function createTaskRoutes(client) {
     const body = c.req.valid("json");
     await assertTaskProjectActive(repo, projectRepo, taskId);
     const result = await pauseTask(mkDeps(repo), taskId, body.reason);
-    return c.json(result, 200);
+    return c.json(writeAck(result, ["status", "pausedAt"], void 0, [{ path: "status", excerpt: result.status }]));
   });
   app.post("/api/tasks/:taskId/resume", zValidator6("json", ResumeRequestSchema), async (c) => {
     const taskId = c.req.param("taskId");
     const body = c.req.valid("json");
     await assertTaskProjectActive(repo, projectRepo, taskId);
     const result = await resumeTask(mkDeps(repo), taskId, body.decision);
-    return c.json(result, 200);
+    return c.json(writeAck(result, ["status"], void 0, [{ path: "status", excerpt: `${result.status}\uFF08\u5DF2\u6062\u590D\u624B\u52A8\u6682\u505C\uFF09` }]));
+  });
+  app.post("/api/tasks/:taskId/cancel", zValidator6("json", CancelRequestSchema), async (c) => {
+    const taskId = c.req.param("taskId");
+    const body = c.req.valid("json");
+    await assertTaskProjectActive(repo, projectRepo, taskId);
+    const result = await cancelTask(mkDeps(repo), taskId, body.reason);
+    return c.json(
+      writeAck(
+        result,
+        ["status", "pausedAt"],
+        void 0,
+        [
+          { path: "status", excerpt: result.status },
+          ...body.reason !== void 0 ? [{ path: "history.reason", excerpt: excerpt(body.reason) }] : []
+        ]
+      )
+    );
   });
   app.get("/api/tasks/:taskId/history", async (c) => {
     const taskId = c.req.param("taskId");
@@ -808,6 +1003,13 @@ function createTaskRoutes(client) {
   });
   app.get("/api/tasks/:taskId/context", async (c) => {
     const taskId = c.req.param("taskId");
+    const viewR = ContextViewSchema.safeParse(c.req.query("view") ?? "basic");
+    if (!viewR.success) {
+      throw new BadRequestError2(
+        `context view '${c.req.query("view")}' is invalid. Valid values: ${CONTEXT_VIEWS.join(", ")}`
+      );
+    }
+    const view = viewR.data;
     const task = await repo.getByTaskId(taskId);
     if (!task) throw new NotFoundError6("task", taskId);
     const currentNodeActive = task.status === "active" ? task.dagInstance.nodes.find((n) => n.id === task.currentNode) : void 0;
@@ -839,7 +1041,7 @@ function createTaskRoutes(client) {
       // （toEntity 不跑 parse 补 default——点路径 $set/$push 只写触及字段，record/doc 内数组
       // 可能缺键，读侧按字段归一到 schema 目标形状，Web/CLI 消费方拿到的恒为完整形）
       taskDoc: normalizeTaskDoc(task.doc),
-      nodeRecords: normalizeNodeRecords(task.nodeRecords),
+      nodeRecords: view === "basic" ? stripArtifactContent(normalizeNodeRecords(task.nodeRecords)) : normalizeNodeRecords(task.nodeRecords),
       archNotes: task.archNotes ?? []
     };
     return c.json(context);
@@ -852,28 +1054,49 @@ function createTaskRoutes(client) {
     if (body.what !== void 0) sets["doc.what"] = body.what;
     if (body.why !== void 0) sets["doc.why"] = body.why;
     if (body.trackNote !== void 0) sets["doc.trackNote"] = body.trackNote;
-    return c.json(await repo.updateTaskPaths(taskId, { sets }));
+    const updatedDoc = await repo.updateTaskPaths(taskId, { sets });
+    return c.json(
+      writeAck(
+        updatedDoc,
+        Object.keys(sets),
+        void 0,
+        Object.entries(sets).map(([path, value]) => ({ path, excerpt: excerpt(String(value)) }))
+      )
+    );
   });
   app.post("/api/tasks/:taskId/doc/acceptance", zValidator6("json", TextItemSchema), async (c) => {
     const taskId = c.req.param("taskId");
     const body = c.req.valid("json");
     await loadTaskForRecordWrite(repo, projectRepo, taskId);
-    return c.json(await repo.updateTaskPaths(taskId, { pushes: { "doc.acceptance": body.text } }));
+    const updatedAcc = await repo.updateTaskPaths(taskId, { pushes: { "doc.acceptance": body.text } });
+    return c.json(
+      writeAck(updatedAcc, ["doc.acceptance"], void 0, [
+        { path: "doc.acceptance", excerpt: excerpt(body.text) }
+      ])
+    );
   });
   app.post("/api/tasks/:taskId/doc/non-goal", zValidator6("json", TextItemSchema), async (c) => {
     const taskId = c.req.param("taskId");
     const body = c.req.valid("json");
     await loadTaskForRecordWrite(repo, projectRepo, taskId);
-    return c.json(await repo.updateTaskPaths(taskId, { pushes: { "doc.nonGoals": body.text } }));
+    const updatedNg = await repo.updateTaskPaths(taskId, { pushes: { "doc.nonGoals": body.text } });
+    return c.json(
+      writeAck(updatedNg, ["doc.nonGoals"], void 0, [{ path: "doc.nonGoals", excerpt: excerpt(body.text) }])
+    );
   });
   app.patch("/api/tasks/:taskId/records/:nodeId/summary", zValidator6("json", RecordSummarySchema), async (c) => {
     const taskId = c.req.param("taskId");
     const nodeId = c.req.param("nodeId");
     const body = c.req.valid("json");
     await loadTaskForRecordWrite(repo, projectRepo, taskId, nodeId);
-    return c.json(await repo.updateTaskPaths(taskId, {
+    const updatedSummary = await repo.updateTaskPaths(taskId, {
       sets: { [`nodeRecords.${nodeId}.summary`]: body.summary }
-    }));
+    });
+    return c.json(
+      writeAck(updatedSummary, [`nodeRecords.${nodeId}.summary`], void 0, [
+        { path: `nodeRecords.${nodeId}.summary`, excerpt: excerpt(body.summary) }
+      ])
+    );
   });
   app.post("/api/tasks/:taskId/records/:nodeId/checks", zValidator6("json", CheckAddSchema), async (c) => {
     const taskId = c.req.param("taskId");
@@ -886,9 +1109,17 @@ function createTaskRoutes(client) {
       item: body.item,
       passed: body.passed ?? true
     };
-    return c.json(await repo.updateTaskPaths(taskId, {
+    const updatedCheck = await repo.updateTaskPaths(taskId, {
       pushes: { [`nodeRecords.${nodeId}.checks`]: check }
-    }));
+    });
+    return c.json(
+      writeAck(
+        updatedCheck,
+        [`nodeRecords.${nodeId}.checks`],
+        { id: check.id, kind: "check" },
+        [{ path: `nodeRecords.${nodeId}.checks`, excerpt: excerpt(`${check.item}\uFF08passed=${String(check.passed)}\uFF09`) }]
+      )
+    );
   });
   app.patch("/api/tasks/:taskId/records/:nodeId/checks/:checkId", zValidator6("json", CheckPatchSchema), async (c) => {
     const taskId = c.req.param("taskId");
@@ -903,10 +1134,15 @@ function createTaskRoutes(client) {
         message: `${BIZ_CODE_MESSAGES6.CHECK_NOT_FOUND}\uFF08node ${nodeId}, check ${checkId}\uFF09`
       });
     }
-    return c.json(await repo.updateTaskPaths(taskId, {
+    const updatedFlip = await repo.updateTaskPaths(taskId, {
       sets: { [`nodeRecords.${nodeId}.checks.$[e].passed`]: body.passed },
       arrayFilters: [{ "e.id": checkId }]
-    }));
+    });
+    return c.json(
+      writeAck(updatedFlip, [`nodeRecords.${nodeId}.checks.${checkId}.passed`], void 0, [
+        { path: `nodeRecords.${nodeId}.checks.${checkId}.passed`, excerpt: String(body.passed) }
+      ])
+    );
   });
   app.post("/api/tasks/:taskId/records/:nodeId/artifacts", zValidator6("json", ArtifactAddSchema), async (c) => {
     const taskId = c.req.param("taskId");
@@ -920,9 +1156,24 @@ function createTaskRoutes(client) {
       ...body.note !== void 0 ? { note: body.note } : {},
       ...body.content !== void 0 ? { content: body.content } : {}
     };
-    return c.json(await repo.updateTaskPaths(taskId, {
+    const updatedArtifact = await repo.updateTaskPaths(taskId, {
       pushes: { [`nodeRecords.${nodeId}.artifacts`]: artifact }
-    }));
+    });
+    return c.json(
+      writeAck(
+        updatedArtifact,
+        [`nodeRecords.${nodeId}.artifacts`],
+        { id: artifact.id, kind: "artifact" },
+        [
+          {
+            path: `nodeRecords.${nodeId}.artifacts`,
+            excerpt: excerpt(
+              `${artifact.type} ${artifact.path}${body.content !== void 0 ? `\uFF08\u542B\u5168\u6587\u5FEB\u7167 ${body.content.length} \u5B57\u7B26\uFF09` : ""}`
+            )
+          }
+        ]
+      )
+    );
   });
   app.post("/api/tasks/:taskId/records/:nodeId/confirmations", zValidator6("json", ConfirmAddSchema), async (c) => {
     const taskId = c.req.param("taskId");
@@ -934,9 +1185,14 @@ function createTaskRoutes(client) {
       quote: body.quote,
       at: /* @__PURE__ */ new Date()
     };
-    return c.json(await repo.updateTaskPaths(taskId, {
+    const updatedConfirm = await repo.updateTaskPaths(taskId, {
       pushes: { [`nodeRecords.${nodeId}.confirmations`]: confirmation }
-    }));
+    });
+    return c.json(
+      writeAck(updatedConfirm, [`nodeRecords.${nodeId}.confirmations`], { id: confirmation.id, kind: "confirmation" }, [
+        { path: `nodeRecords.${nodeId}.confirmations`, excerpt: excerpt(confirmation.quote) }
+      ])
+    );
   });
   app.post("/api/tasks/:taskId/records/:nodeId/decisions", zValidator6("json", DecisionAddSchema), async (c) => {
     const taskId = c.req.param("taskId");
@@ -948,25 +1204,40 @@ function createTaskRoutes(client) {
       topic: body.topic,
       decision: body.decision
     };
-    return c.json(await repo.updateTaskPaths(taskId, {
+    const updatedDecision = await repo.updateTaskPaths(taskId, {
       pushes: { [`nodeRecords.${nodeId}.decisions`]: decision }
-    }));
+    });
+    return c.json(
+      writeAck(updatedDecision, [`nodeRecords.${nodeId}.decisions`], { id: decision.id, kind: "decision" }, [
+        { path: `nodeRecords.${nodeId}.decisions`, excerpt: excerpt(`${decision.topic}: ${decision.decision}`) }
+      ])
+    );
   });
   app.put("/api/tasks/:taskId/records/:nodeId/review", zValidator6("json", ReviewSetSchema), async (c) => {
     const taskId = c.req.param("taskId");
     const nodeId = c.req.param("nodeId");
     const body = c.req.valid("json");
     await loadTaskForRecordWrite(repo, projectRepo, taskId, nodeId);
-    return c.json(await repo.updateTaskPaths(taskId, {
+    const updatedReview = await repo.updateTaskPaths(taskId, {
       sets: { [`nodeRecords.${nodeId}.review`]: body }
-    }));
+    });
+    return c.json(
+      writeAck(updatedReview, [`nodeRecords.${nodeId}.review`], void 0, [
+        { path: `nodeRecords.${nodeId}.review`, excerpt: `${body.verdict}\uFF08rounds=${String(body.rounds)}, critical=${String(body.critical)}\uFF09` }
+      ])
+    );
   });
   app.post("/api/tasks/:taskId/archnotes", zValidator6("json", TextItemSchema), async (c) => {
     const taskId = c.req.param("taskId");
     const body = c.req.valid("json");
     const task = await loadTaskForRecordWrite(repo, projectRepo, taskId);
     const note = { id: generateEntryId((task.archNotes ?? []).map((n) => n.id)), text: body.text, at: /* @__PURE__ */ new Date() };
-    return c.json(await repo.updateTaskPaths(taskId, { pushes: { archNotes: note } }));
+    const updatedNote = await repo.updateTaskPaths(taskId, { pushes: { archNotes: note } });
+    return c.json(
+      writeAck(updatedNote, ["archNotes"], { id: note.id, kind: "archnote" }, [
+        { path: "archNotes", excerpt: excerpt(note.text) }
+      ])
+    );
   });
   return app;
 }
@@ -1116,7 +1387,7 @@ import { serve } from "@hono/node-server";
 import { createMongoClient } from "@siming-org/core";
 
 // src/ensure-collections.ts
-import { EnumRegistrySchema } from "@siming-org/core";
+import { EnumRegistrySchema, bumpPatch as bumpPatch2 } from "@siming-org/core";
 async function ensureCollections(client) {
   const db = client.db();
   await Promise.all([
@@ -1132,6 +1403,7 @@ async function ensureCollections(client) {
   await migrateGateRemovalData(db);
   await migrateTaskRecordData(db);
   await migrateDagTrackTaskValues(db);
+  await migrateAgentFunctionBackfill(db);
   await ensurePostMigrationIndexes(db);
 }
 var ENUM_REGISTRY_SEEDS = {
@@ -1174,6 +1446,12 @@ var ENUM_REGISTRY_SEEDS = {
   scope: [
     { value: "global", label: "\u5168\u5C40", builtin: true },
     { value: "project", label: "\u9879\u76EE", builtin: true }
+  ],
+  // T202608260002 C3：schema 固定枚举为消费权威（AgentFunctionSchema），registry 仅展示（仿 pause_type 双轨）——
+  // web 后续经 useEnumEntries('agent_function') 消费；两值 builtin（writer 落盘注入按 reviewer 判定，承重字段）
+  agent_function: [
+    { value: "reviewer", label: "\u5BA1\u67E5\uFF08\u843D\u76D8\u6CE8\u5165\u4FE1\u606F\u8FB9\u754C\uFF09", builtin: true },
+    { value: "executor", label: "\u6267\u884C/\u901A\u7528\uFF08\u9ED8\u8BA4\uFF09", builtin: true }
   ]
 };
 function buildSeedEntries(seeds) {
@@ -1258,10 +1536,24 @@ async function ensureSkillCollection(db) {
       content: { bsonType: "string" },
       // N016 F9：category 放宽为任意字符串（枚举注册表为运行时权威，DB 只做类型兜底）
       category: { bsonType: "string" },
+      // T202608270002：引用文档（可选，存量单文件资产无此字段合法）——路径规则/上限归应用层 Zod，DB 只做类型级声明
+      references: {
+        bsonType: "array",
+        items: {
+          bsonType: "object",
+          required: ["path", "content"],
+          properties: {
+            path: { bsonType: "string", minLength: 1 },
+            content: { bsonType: "string" }
+          }
+        }
+      },
       // N012 F7：作用域字段（全局 / 项目专用）；projectId 仅 scope=project 携带
       scope: { enum: ["global", "project"] },
       projectId: { bsonType: "string" },
       version: { bsonType: "string" },
+      // T202608290001：资产启停（可选——enabled === false 即停用，缺失 = 启用，存量零迁移）
+      enabled: { bsonType: "bool" },
       createdAt: { bsonType: "date" },
       updatedAt: { bsonType: "date" }
     }
@@ -1288,8 +1580,24 @@ async function ensureAgentCollection(db) {
       version: { bsonType: "string" },
       tools: { bsonType: "array", items: { bsonType: "string" } },
       permissions: { bsonType: "array", items: { bsonType: "string" } },
+      // T202608270002：引用文档（可选，存量单文件资产无此字段合法）——路径规则/上限归应用层 Zod，DB 只做类型级声明
+      references: {
+        bsonType: "array",
+        items: {
+          bsonType: "object",
+          required: ["path", "content"],
+          properties: {
+            path: { bsonType: "string", minLength: 1 },
+            content: { bsonType: "string" }
+          }
+        }
+      },
       scope: { enum: ["global", "project"] },
       projectId: { bsonType: "string" },
+      // T202608260002：功能类型（可选——存量缺省合法，M12 回填）——取值域归应用层 Zod，DB 只做类型兜底
+      "function": { bsonType: "string" },
+      // T202608290001：资产启停（可选——enabled === false 即停用，缺失 = 启用，存量零迁移）
+      enabled: { bsonType: "bool" },
       createdAt: { bsonType: "date" },
       updatedAt: { bsonType: "date" }
     }
@@ -1315,6 +1623,8 @@ async function ensureDagTemplateCollection(db) {
       edges: { bsonType: "array" },
       isDefault: { bsonType: "bool" },
       version: { bsonType: "string" },
+      // T202608290001：模板启停（可选——enabled === false 即停用，缺失 = 启用，存量零迁移）
+      enabled: { bsonType: "bool" },
       createdAt: { bsonType: "date" },
       updatedAt: { bsonType: "date" }
     }
@@ -1452,6 +1762,22 @@ async function migrateDagTrackTaskValues(db) {
     throw new Error("T202608240003 M11 \u8FC1\u79FB\u5931\u8D25\uFF1Adag_track doc \u66F4\u65B0\u672A\u547D\u4E2D\uFF08\u542F\u52A8\u671F\u4E0D\u5E94\u53D1\u751F\uFF09");
   }
 }
+async function migrateAgentFunctionBackfill(db) {
+  const coll = db.collection("agents");
+  const docs = await coll.find({ "function": { $exists: false } }, { projection: { version: 1 } }).toArray();
+  if (docs.length === 0) return;
+  console.log(`[siming] T202608260002 M12\uFF1Aagents.function \u56DE\u586B ${docs.length} \u4E2A\uFF08executor + version bump\uFF0C\u9A71\u52A8\u5DF2\u88C5\u73AF\u5883\u91CD\u5199\uFF09`);
+  for (const doc of docs) {
+    const baseVersion = typeof doc.version === "string" ? doc.version : "1.0.0";
+    const result = await coll.updateOne(
+      { _id: doc._id, "function": { $exists: false } },
+      { $set: { "function": "executor", version: bumpPatch2(baseVersion) } }
+    );
+    if (result.matchedCount === 0) {
+      throw new Error("T202608260002 M12 \u8FC1\u79FB\u5931\u8D25\uFF1Aagents.function \u56DE\u586B\u672A\u547D\u4E2D\uFF08\u542F\u52A8\u671F\u5355\u8FDB\u7A0B\u4E32\u884C\uFF0C\u4E0D\u5E94\u53D1\u751F\uFF09");
+    }
+  }
+}
 async function ensurePostMigrationIndexes(db) {
   const tasks = db.collection("tasks");
   const taskIndexes = await tasks.listIndexes().toArray();