real life totally configurabl ai subasians

packages/opencode/src/tool/multiedit.ts

@@ -10,12 +10,22 @@ export const MultiEditTool = Tool.define({
   description: DESCRIPTION,
   parameters: z.object({
     filePath: z.string().describe("The absolute path to the file to modify"),
-    edits: z.array(EditTool.parameters).describe("Array of edit operations to perform sequentially on the file"),
+    edits: z
+      .array(
+        z.object({
+          filePath: z.string().describe("The absolute path to the file to modify"),
+          oldString: z.string().describe("The text to replace"),
+          newString: z.string().describe("The text to replace it with (must be different from oldString)"),
+          replaceAll: z.boolean().optional().describe("Replace all occurrences of oldString (default false)"),
+        }),
+      )
+      .describe("Array of edit operations to perform sequentially on the file"),
   }),
   async execute(params, ctx) {
+    const tool = await EditTool()
     const results = []
     for (const [, edit] of params.edits.entries()) {
-      const result = await EditTool.execute(
+      const result = await tool.execute(
         {
           filePath: params.filePath,
           oldString: edit.oldString,

packages/opencode/src/tool/task.ts

@@ -5,62 +5,71 @@ import { Session } from "../session"
 import { Bus } from "../bus"
 import { MessageV2 } from "../session/message-v2"
 import { Identifier } from "../id/id"
+import { Agent } from "../agent/agent"
 
-export const TaskTool = Tool.define({
-  id: "task",
-  description: DESCRIPTION,
-  parameters: z.object({
-    description: z.string().describe("A short (3-5 words) description of the task"),
-    prompt: z.string().describe("The task for the agent to perform"),
-  }),
-  async execute(params, ctx) {
-    const session = await Session.create(ctx.sessionID)
-    const msg = await Session.getMessage(ctx.sessionID, ctx.messageID)
-    if (msg.role !== "assistant") throw new Error("Not an assistant message")
+export const TaskTool = Tool.define(async () => {
+  const agents = await Agent.list()
+  const description = DESCRIPTION.replace("{agents}", agents.map((a) => `- ${a.name}: ${a.description}`).join("\n"))
+  return {
+    id: "task",
+    description,
+    parameters: z.object({
+      description: z.string().describe("A short (3-5 words) description of the task"),
+      prompt: z.string().describe("The task for the agent to perform"),
+      subagent_type: z.string().describe("The type of specialized agent to use for this task"),
+    }),
+    async execute(params, ctx) {
+      const session = await Session.create(ctx.sessionID)
+      const msg = await Session.getMessage(ctx.sessionID, ctx.messageID)
+      if (msg.role !== "assistant") throw new Error("Not an assistant message")
+      const agent = await Agent.get(params.subagent_type)
+      const messageID = Identifier.ascending("message")
+      const parts: Record<string, MessageV2.ToolPart> = {}
+      const unsub = Bus.subscribe(MessageV2.Event.PartUpdated, async (evt) => {
+        if (evt.properties.part.sessionID !== session.id) return
+        if (evt.properties.part.messageID === messageID) return
+        if (evt.properties.part.type !== "tool") return
+        parts[evt.properties.part.id] = evt.properties.part
+        ctx.metadata({
+          title: params.description,
+          metadata: {
+            summary: Object.values(parts).sort((a, b) => a.id?.localeCompare(b.id)),
+          },
+        })
+      })
 
-    const messageID = Identifier.ascending("message")
-    const parts: Record<string, MessageV2.ToolPart> = {}
-    const unsub = Bus.subscribe(MessageV2.Event.PartUpdated, async (evt) => {
-      if (evt.properties.part.sessionID !== session.id) return
-      if (evt.properties.part.messageID === messageID) return
-      if (evt.properties.part.type !== "tool") return
-      parts[evt.properties.part.id] = evt.properties.part
-      ctx.metadata({
+      const model = agent.model ?? {
+        modelID: msg.modelID,
+        providerID: msg.providerID,
+      }
+
+      ctx.abort.addEventListener("abort", () => {
+        Session.abort(session.id)
+      })
+      const result = await Session.chat({
+        messageID,
+        sessionID: session.id,
+        modelID: model.modelID,
+        providerID: model.providerID,
+        mode: msg.mode,
+        system: agent.prompt,
+        tools: agent.tools,
+        parts: [
+          {
+            id: Identifier.ascending("part"),
+            type: "text",
+            text: params.prompt,
+          },
+        ],
+      })
+      unsub()
+      return {
         title: params.description,
         metadata: {
-          summary: Object.values(parts).sort((a, b) => a.id?.localeCompare(b.id)),
+          summary: result.parts.filter((x) => x.type === "tool"),
         },
-      })
-    })
-
-    ctx.abort.addEventListener("abort", () => {
-      Session.abort(session.id)
-    })
-    const result = await Session.chat({
-      messageID,
-      sessionID: session.id,
-      modelID: msg.modelID,
-      providerID: msg.providerID,
-      mode: msg.mode,
-      tools: {
-        todoread: false,
-        todowrite: false,
-      },
-      parts: [
-        {
-          id: Identifier.ascending("part"),
-          type: "text",
-          text: params.prompt,
-        },
-      ],
-    })
-    unsub()
-    return {
-      title: params.description,
-      metadata: {
-        summary: result.parts.filter((x) => x.type === "tool"),
-      },
-      output: result.parts.findLast((x) => x.type === "text")!.text,
-    }
-  },
+        output: result.parts.findLast((x) => x.type === "text")!.text,
+      }
+    },
+  }
 })

packages/opencode/src/tool/task.txt

@@ -1,12 +1,19 @@
-Launch a new agent that has access to the following tools: Bash, Glob, Grep, LS, Read, Edit, MultiEdit, Write, NotebookRead, NotebookEdit, WebFetch, TodoRead, TodoWrite, WebSearch. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries, use the Agent tool to perform the search for you.
+Launch a new agent to handle complex, multi-step tasks autonomously. 
+
+Available agent types and the tools they have access to:
+{agents}
+
+When using the Task tool, you must specify a subagent_type parameter to select which agent type to use.
 
 When to use the Agent tool:
-- If you are searching for a keyword like "config" or "logger", or for questions like "which file does X?", the Agent tool is strongly recommended
+- When you are instructed to execute custom slash commands. Use the Agent tool with the slash command invocation as the entire prompt. The slash command can take arguments. For example: Task(description="Check the file", prompt="/check-file path/to/file.py")
 
 When NOT to use the Agent tool:
 - If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly
 - If you are searching for a specific class definition like "class Foo", use the Glob tool instead, to find the match more quickly
 - If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly
+- Other tasks that are not related to the agent descriptions above
+
 
 Usage notes:
 1. Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses
@@ -14,3 +21,40 @@ Usage notes:
 3. Each agent invocation is stateless. You will not be able to send additional messages to the agent, nor will the agent be able to communicate with you outside of its final report. Therefore, your prompt should contain a highly detailed task description for the agent to perform autonomously and you should specify exactly what information the agent should return back to you in its final and only message to you.
 4. The agent's outputs should generally be trusted
 5. Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent
+6. If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.
+
+Example usage:
+
+<example_agent_descriptions>
+"code-reviewer": use this agent after you are done writing a signficant piece of code
+"greeting-responder": use this agent when to respond to user greetings with a friendly joke
+</example_agent_description>
+
+<example>
+user: "Please write a function that checks if a number is prime"
+assistant: Sure let me write a function that checks if a number is prime
+assistant: First let me use the Write tool to write a function that checks if a number is prime
+assistant: I'm going to use the Write tool to write the following code:
+<code>
+function isPrime(n) {
+  if (n <= 1) return false
+  for (let i = 2; i * i <= n; i++) {
+    if (n % i === 0) return false
+  }
+  return true
+}
+</code>
+<commentary>
+Since a signficant piece of code was written and the task was completed, now use the code-reviewer agent to review the code
+</commentary>
+assistant: Now let me use the code-reviewer agent to review the code
+assistant: Uses the Task tool to launch the with the code-reviewer agent 
+</example>
+
+<example>
+user: "Hello"
+<commentary>
+Since the user is greeting, use the greeting-responder agent to respond with a friendly joke
+</commentary>
+assistant: "I'm going to use the Task tool to launch the with the greeting-responder agent"
+</example>

packages/opencode/src/tool/tool.ts

@@ -25,8 +25,8 @@ export namespace Tool {
   }
 
   export function define<Parameters extends StandardSchemaV1, Result extends Metadata>(
-    input: Info<Parameters, Result>,
-  ): Info<Parameters, Result> {
-    return input
+    input: Info<Parameters, Result> | (() => Promise<Info<Parameters, Result>>),
+  ): () => Promise<Info<Parameters, Result>> {
+    return input instanceof Function ? input : async () => input
   }
 }