openAgent

1import { PermissionV1 } from "@opencode-ai/core/v1/permission"
2import { CrossSpawnSpawner } from "@opencode-ai/core/cross-spawn-spawner"
3import { LayerNode } from "@opencode-ai/core/effect/layer-node"
4import { Ripgrep } from "@opencode-ai/core/ripgrep"
5import { Cause, Effect, Exit, Layer } from "effect"
6import { afterEach, describe, expect } from "bun:test"
7import path from "path"
8import type { Permission } from "../../src/permission"
9import type { Tool } from "@/tool/tool"
10import { SkillTool } from "../../src/tool/skill"
11import { ToolRegistry } from "@/tool/registry"
12import { disposeAllInstances, TestInstance } from "../fixture/fixture"
13import { SessionID, MessageID } from "../../src/session/schema"
14import { testEffect } from "../lib/effect"
15 
16const baseCtx: Omit<Tool.Context, "ask"> = {
17  sessionID: SessionID.make("ses_test"),
18  messageID: MessageID.make("msg_test"),
19  callID: "",
20  agent: "build",
21  abort: AbortSignal.any([]),
22  messages: [],
23  metadata: () => Effect.void,
24}
25 
26afterEach(async () => {
27  await disposeAllInstances()
28})
29 
30const it = testEffect(LayerNode.compile(LayerNode.group([ToolRegistry.node, CrossSpawnSpawner.node, Ripgrep.node])))
31 
32describe("tool.skill", () => {
33  it.instance("execute returns skill content block with files", () =>
34    Effect.gen(function* () {
35      const dir = (yield* TestInstance).directory
36      const skill = path.join(dir, ".opencode", "skill", "tool-skill")
37      yield* Effect.promise(() =>
38        Bun.write(
39          path.join(skill, "SKILL.md"),
40          `---
41name: tool-skill
42description: Skill for tool tests.
43---
44 
45# Tool Skill
46 
47Use this skill.
48`,
49        ),
50      )
51      yield* Effect.promise(() => Bun.write(path.join(skill, "scripts", "demo.txt"), "demo"))
52 
53      const home = process.env.OPENCODE_TEST_HOME
54      process.env.OPENCODE_TEST_HOME = dir
55      yield* Effect.addFinalizer(() =>
56        Effect.sync(() => {
57          process.env.OPENCODE_TEST_HOME = home
58        }),
59      )
60 
61      const registry = yield* ToolRegistry.Service
62      const agent = { name: "build", mode: "primary" as const, permission: [], options: {} }
63      const tool = (yield* registry.tools({
64        providerID: "opencode" as any,
65        modelID: "gpt-5" as any,
66        agent,
67      })).find((tool) => tool.id === SkillTool.id)
68      if (!tool) throw new Error("Skill tool not found")
69 
70      expect(tool.description).not.toContain("tool-skill")
71      expect(tool.description).not.toContain("Skill for tool tests.")
72 
73      const requests: Array<Omit<PermissionV1.Request, "id" | "sessionID" | "tool">> = []
74      const ctx: Tool.Context = {
75        ...baseCtx,
76        ask: (req) =>
77          Effect.sync(() => {
78            requests.push(req)
79          }),
80      }
81 
82      const result = yield* tool.execute({ name: "tool-skill" }, ctx)
83      const file = path.resolve(skill, "scripts", "demo.txt")
84 
85      expect(requests.length).toBe(1)
86      expect(requests[0].permission).toBe("skill")
87      expect(requests[0].patterns).toContain("tool-skill")
88      expect(requests[0].always).toContain("tool-skill")
89      expect(result.metadata.dir).toBe(skill)
90      expect(result.output).toContain(`<skill_content name="tool-skill">`)
91      expect(result.output).toContain(`Base directory for this skill: ${skill}`)
92      expect(result.output).toContain(`<file>${file}</file>`)
93    }),
94  )
95 
96  it.instance("execute preserves not found message", () =>
97    Effect.gen(function* () {
98      const dir = (yield* TestInstance).directory
99      const home = process.env.OPENCODE_TEST_HOME
100      process.env.OPENCODE_TEST_HOME = dir
101      yield* Effect.addFinalizer(() =>
102        Effect.sync(() => {
103          process.env.OPENCODE_TEST_HOME = home
104        }),
105      )
106 
107      const registry = yield* ToolRegistry.Service
108      const agent = { name: "build", mode: "primary" as const, permission: [], options: {} }
109      const tool = (yield* registry.tools({
110        providerID: "opencode" as any,
111        modelID: "gpt-5" as any,
112        agent,
113      })).find((tool) => tool.id === SkillTool.id)
114      if (!tool) throw new Error("Skill tool not found")
115 
116      const exit = yield* tool
117        .execute(
118          { name: "missing-skill" },
119          {
120            ...baseCtx,
121            ask: () => Effect.void,
122          },
123        )
124        .pipe(Effect.exit)
125 
126      expect(Exit.isFailure(exit)).toBe(true)
127      if (Exit.isFailure(exit)) {
128        const error = Cause.squash(exit.cause)
129        expect(error).toBeInstanceOf(Error)
130        if (error instanceof Error) expect(error.message).toContain('Skill "missing-skill" not found.')
131      }
132    }),
133  )
134})
135