Something went wrong. Try again.
opencode v2 mirror
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109/** * Model-facing file-write leaf. Relative paths resolve within the active * Location. Absolute paths inside that Location are accepted, while explicit * absolute external paths retain mutation capability through a separate * external_directory approval before edit approval. */export * as WriteTool from "./write.js"
import type { Context } from "@opencode-ai/plugin/effect/plugin"import { ToolFailure } from "@opencode-ai/ai"import { Effect, Schema } from "effect"import { Bom } from "@opencode-ai/util/bom"import { Environment } from "../../environment/index.js"import { FileMutation } from "../../file-mutation.js"import { Formatter } from "../../formatter.js"import { LocationMutation } from "../../location-mutation.js"import { Permission } from "../../permission.js"import { fileDiff } from "./file-diff.js"
export const name = "write"
// TODO: Revisit whether model-facing mutation schemas should prefer absolute `filePath` naming for trained-in compatibility after evaluating model behavior.export const Input = Schema.Struct({ path: Schema.String.annotate({ description: "Path to the file to write to", }), content: Schema.String.annotate({ description: "Content to write to the file" }),})
export const Output = Schema.Struct({ operation: Schema.Literal("write"), target: Schema.String, resource: Schema.String, existed: Schema.Boolean,})export type Output = typeof Output.Type
export const toModelContent = (output: Output) => `${output.existed ? "Wrote" : "Created"} file successfully: ${output.resource}`
/** Deferred write UX integrations remain visible at the model-facing seam. */// TODO: Publish watcher/file-edit events after watcher integration exists.// TODO: Add snapshots / undo after design exists.// TODO: Add LSP notification and diagnostics after LSP runtime exists.
export const Plugin = { id: "opencode.tool.write", effect: Effect.fn("WriteTool.Plugin")(function* (ctx: Context) { const mutation = yield* LocationMutation.Service const fileMutation = yield* FileMutation.Service const environment = yield* Environment.Service const formatter = yield* Formatter.Service const permission = yield* Permission.Service
yield* ctx.tool .transform((draft) => draft.add({ name, options: { codemode: false, permission: "edit" }, description: "Writes a file to the local filesystem, overwriting if one exists.\n\nMissing parent directories are created automatically.\n\nUse this tool to create new files or overwrite existing files. For partial changes, use the edit tool instead.", input: Input, output: Output, execute: (input, context) => Effect.gen(function* () { const source = { type: "tool" as const, messageID: context.messageID, id: context.id, } const target = yield* mutation.resolve({ path: input.path, kind: "file" }) const external = target.externalDirectory if (external) yield* permission.assert({ ...LocationMutation.externalDirectoryPermission(external), sessionID: context.sessionID, agent: context.agent, source, }) const current = yield* FileMutation.readText(environment.files, target.absolute).pipe( Effect.catchTag("Environment.NotFound", () => Effect.undefined), ) const next = Bom.split(input.content) const preview = fileDiff(target.resource, current?.text ?? "", next.text, current ? "modified" : "added") yield* permission.assert({ action: "edit", resources: [target.resource], save: ["*"], metadata: { files: [preview] }, sessionID: context.sessionID, agent: context.agent, source, }) const result = yield* fileMutation.writeTextPreservingBom({ target, content: input.content }) const bom = (yield* FileMutation.readText(environment.files, target.absolute)).bom if (yield* formatter.file(target.absolute)) { yield* FileMutation.syncTextBom(environment.files, target.absolute, bom) } return result }).pipe( Effect.map((output) => ({ output, content: toModelContent(output) })), Effect.mapError((error) => new ToolFailure({ message: `Unable to write ${input.path}`, error })), ), }), ) .pipe(Effect.orDie) }),}