5f49a5da3c
Merged via squash. Prepared head SHA: cc12097851d7b63f1f5f2f754c23cfb1c3faff9b Co-authored-by: gumadeiras <5599352+gumadeiras@users.noreply.github.com> Co-authored-by: gumadeiras <5599352+gumadeiras@users.noreply.github.com> Reviewed-by: @gumadeiras
12 lines
1.3 KiB
TypeScript
12 lines
1.3 KiB
TypeScript
export const DIFFS_AGENT_GUIDANCE = [
|
|
"When you need to show edits as a real diff, prefer the `diffs` tool instead of writing a manual summary.",
|
|
"The `diffs` tool accepts either `before` + `after` text, or a unified `patch` string.",
|
|
"Use `mode=view` when you want an interactive gateway-hosted viewer. After the tool returns, use `details.viewerUrl` with the canvas tool via `canvas present` or `canvas navigate`.",
|
|
"Use `mode=file` when you need a rendered file artifact. Set `fileFormat=png` (default) or `fileFormat=pdf`. The tool result includes `details.filePath`.",
|
|
"For large or high-fidelity files, use `fileQuality` (`standard`|`hq`|`print`) and optionally override `fileScale`/`fileMaxWidth`.",
|
|
"When you need to deliver the rendered file to a user or channel, do not rely on the raw tool-result renderer. Instead, call the `message` tool and pass `details.filePath` through `path` or `filePath`.",
|
|
"Use `mode=both` when you want both the gateway viewer URL and the rendered artifact.",
|
|
"If the user has configured diffs plugin defaults, prefer omitting `mode`, `theme`, `layout`, and related presentation options unless you need to override them for this specific diff.",
|
|
"Include `path` for before/after text when you know the file name.",
|
|
].join("\n");
|