// packages/opencode/src/agent/agent.ts (lines 107-233)

// 1. build — 主执行 Agent（默认）
const BUILD_AGENT: Agent.Info = {
  name: "build",
  mode: "primary",
  permission: [
    { permission: "read", pattern: "*", action: "allow" },
    { permission: "edit", pattern: "*", action: "allow" },
    { permission: "bash", pattern: "*", action: "allow" },
    // ...
  ],
}

// 2. plan — 计划模式 Agent（只读）
const PLAN_AGENT: Agent.Info = {
  name: "plan",
  mode: "primary",
  permission: [
    { permission: "read", pattern: "*", action: "allow" },
    { permission: "edit", pattern: ".opencode/plans/*", action: "allow" },
    // edit/write/bash 全被 deny
  ],
}

// 3. general — 通用研究 Agent
const GENERAL_AGENT: Agent.Info = {
  name: "general",
  mode: "subagent",
  permission: [
    { permission: "read", pattern: "*", action: "allow" },
    { permission: "edit", pattern: "*", action: "allow" },
    { permission: "bash", pattern: "*", action: "allow" },
    // todowrite 被 deny
  ],
}

// 4. explore — 快速探索 Agent（只读）
const EXPLORE_AGENT: Agent.Info = {
  name: "explore",
  mode: "subagent",
  permission: [
    { permission: "read", pattern: "*", action: "allow" },
    { permission: "glob", pattern: "*", action: "allow" },
    { permission: "grep", pattern: "*", action: "allow" },
  ],
}

// 5. compaction — 内部压缩 Agent（隐藏）
// 6. title — 会话标题生成（隐藏）
// 7. summary — 会话总结生成（隐藏）

// packages/opencode/src/tool/task.ts
export const TaskTool = Tool.define("task", async (ctx) => {
  const agents = await Agent.list().then(x =>
    x.filter(a => a.mode !== "primary")  // 仅子 Agent
  )

  const parameters = z.object({
    description: z.string().describe("Short description (3-5 words)"),
    prompt: z.string().describe("The task for the agent"),
    subagent_type: z.string().describe("Agent type to use"),
    task_id: z.string().optional().describe("Resume a previous task"),
    command: z.string().optional(),
  })

  return {
    description,
    parameters,
    async execute(params, ctx) {
      // === 恢复已有任务 ===
      if (params.task_id) {
        const session = yield* Session.load(params.task_id)
        const result = yield* SessionPrompt.prompt({
          messageID: MessageID.ascending(),
          sessionID: session.id,
          // ... 继续执行
        })
        return formatResult(result)
      }

      // === 创建新任务 ===
      // 1. 获取子 Agent
      const agent = yield* Agent.get(params.subagent_type)

      // 2. 权限检查
      const hasTaskPermission = agent.permission.some(r => r.permission === "task")
      const hasTodoWritePermission = agent.permission.some(r => r.permission === "todowrite")

      // 3. 创建子会话
      const session = yield* Session.create({
        parentID: ctx.sessionID,  // 关键：关联父会话
        title: params.description + ` (@${agent.name} subagent)`,
        permission: [
          // 禁用递归 task 调用（防止无限派生）
          ...(hasTaskPermission ? [] : [{ permission: "task", pattern: "*", action: "deny" }]),
          // todowrite 权限继承
          ...(hasTodoWritePermission ? [] : [{ permission: "todowrite", pattern: "*", action: "deny" }]),
        ],
      })

      // 4. 在子会话中执行
      const messageID = MessageID.ascending()
      const result = yield* SessionPrompt.prompt({
        messageID,
        sessionID: session.id,
        model: { modelID: model.modelID, providerID: model.providerID },
        agent: agent.name,
        tools: {
          todowrite: hasTodoWritePermission ? undefined : false,
          task: hasTaskPermission ? undefined : false,
        },
        parts: promptParts,
      })

      // 5. 格式化结果
      const text = result.parts.findLast(x => x.type === "text")?.text ?? ""

      return {
        title: params.description,
        metadata: { sessionId: session.id, model },
        output: [
          `task_id: ${session.id} (for resuming to continue this task if needed)`,
          "",
          "<task_result>",
          text,
          "</task_result>",
        ].join("\n"),
      }
    },
  }
})