chore: deprecate coder_ai_task and coder_task

[blinkagent]

Coder Tasks is deprecated as of Coder v2.34 and is superseded by Coder Agents (Chats API). Starting June 2, 2026, Coder Tasks moves to a 12-month Extended Support Release (ESR) for Premium customers. Templates no longer require AI task resources, so the provider surface for them is now marked deprecated.

Changes

provider/ai_task.go:

• coder_ai_task resource: added DeprecationMessage and a ~> deprecation notice in the description.
• coder_task data source: same.
• Attributes marked Deprecated: coder_ai_task.app_id, coder_ai_task.prompt, coder_ai_task.enabled, coder_ai_task.sidebar_app.id, coder_task.prompt, coder_task.enabled. sidebar_app was already deprecated in favour of app_id; its message now also mentions the Tasks deprecation.
• // Deprecated: doc comments on the exported AITask and AITaskSidebarApp types, and on TaskPromptParameterName. The constant is no longer referenced by coder/coder (removed in refactor: remove deprecated AITaskPromptParameterName constant coder#21023) but is exported, so it is kept.
• id was intentionally left un-deprecated on both, since it is the resource identifier rather than a task-specific attribute.

Attribute-level messages are deliberately short because scripts/docsgen renders them inline in the attribute list; the resource/data-source level notice carries the ESR wording and the migration link.

Also fixes a broken reference in examples/data-sources/coder_task/data-source.tf, which pointed at a non-existent coder_ai_task data source. That example is embedded in the published coder_task docs page.

docs/ regenerated with make gen.

Testing

TF_ACC=1 go test ./provider/... passes.

Created on behalf of @matifali

[david-fraley]

Main comment is the date's you mentioned -- Tasks were technically deprecated in v2.34, and 2.37 is when we're "hiding" them aka ripping out what we can right now. So inaccurate to say deprecated as of 2.36. Can you update to point to 2.34? If needed, you can point here -- https://coder.com/docs/@v2.36.3/ai-coder/tasks

The official language Matt and I used was "Starting June 2, 2026, Coder Tasks will move to a 12-month Extended Support Release (ESR) for Premium customers."

[matifali]

@david-fraley Thanks. Will Address.

[blinkagent]

Thanks @david-fraley — corrected in 699ccfb. All references now say v2.34, and the rendered docs notice carries the official wording:

Coder Tasks is deprecated as of Coder v2.34 and will be removed in a future release. Starting June 2, 2026, Coder Tasks moves to a 12-month Extended Support Release (ESR) for Premium customers. Templates no longer require AI task resources; use Coder Agents and follow the migration guide. Coder Tasks documentation remains available in the v2.36 documentation.

The shorter messages Terraform prints at plan time (resource, data source, and per-attribute) also say v2.34.

One heads-up while we're on dates: coder/coder currently states v2.36 in two places, so those disagree with v2.34 as well —

• docs/ai-coder/agents/tasks-to-chats-migration.md: "Coder Tasks is deprecated as of Coder v2.36 and is no longer available by default"
• coderd/aitasks.go: // Deprecated: Coder Tasks is deprecated as of v2.36.

Happy to open a follow-up PR against coder/coder to align those on v2.34 if that's the right number there too.

[david-fraley]

docs/ai-coder/agents/tasks-to-chats-migration.md: "Coder Tasks is deprecated as of Coder v2.36 and is no longer available by default" coderd/aitasks.go: // Deprecated: Coder Tasks is deprecated as of v2.36.

ugh ya those should prob say 2.34.

[linear-code]

CODAGT-1000