Linear: [CODAGT-1101](https://linear.app/codercom/issue/CODAGT-1101/agent-plugins-read-only-support-behind-the-agent-plugins-experiment) **tl;dr:** Adds the `agent-plugins` experiment and the Agent API v2.17 messages that carry Agent Plugins data from the agent to coderd. First of eight stacked PRs adding read-only [Agent Plugins](https://agent-plugins.org/) v1.0.0 support. A plugin is a directory with a `plugin.json` manifest, skills under `skills/`, and an optional `mcp.json`. Across the stack, the agent discovers plugins in `plugins/` and `.agents/plugins/` under its scan roots (for example `~/.coder/plugins/<name>`), chatd lists their skills with plugin attribution, the agent runs the MCP servers of plugins in the workspace working directory, and the Agents page shows plugin attribution in the chat context. Hooks, commands, agents, install flows, and org-managed plugins are out of scope. Background: [research/agent-plugins-standard.md](https://github.com/coder/scott-misc/blob/main/research/agent-plugins-standard.md) (internal). This PR adds `codersdk.ExperimentAgentPlugins` and a `PluginBody` oneof variant on `ContextResource` (tag 18) that carries the validated manifest fields and nests the plugin's skills and MCP servers. `Manifest` gains `agent_plugins_enabled` (field 23), which coderd sets when the experiment is enabled; the agent discovers plugins only then. coderd stores each nested resource as its own row with the plugin's name in a new `plugin_name` column (migration 000642), which the hydrate, MCP sync, and re-pin queries copy. With the experiment off, `PushContextState` drops plugin resources and everything nested in them. Otherwise it rejects pushes with plugin names that fail `workspacesdk.ValidatePluginName` (the spec's name grammar, shared by agent and coderd), OK plugins without a name or with a duplicate name, a non-OK plugin that nests resources, nested entries of the wrong kind, plugin skill sources outside `<plugin source>/skills/`, and plugin MCP servers with an empty `server_name` or a source other than `<plugin name>/<server_name>`. Nested resources count toward the 1000-resource cap. Agents now dial v2.17, so a new agent needs a coderd that supports it, as with every Agent API minor. Turning the experiment off does not remove plugin data already pinned to existing chats. <!-- pr-map:start --> <details><summary>PR map</summary> `main..4b0cfc9657` | Category | Files | + | - | |---|---:|---:|---:| | prod (backend) | 15 | 342 | 78 | | test (backend) | 9 | 534 | 3 | | migrations | 2 | 14 | 0 | | generated (backend) | 7 | 1216 | 1027 | | generated (frontend) | 1 | 2 | 0 | | **Total** | 34 | 2108 | 1108 | 1. `coderd/agentapi/context.go` (+211/-51, API): drops plugin resources when the experiment is off; otherwise validates plugin names and nesting, and stores each nested skill and MCP server as its own row with the plugin's name. 2. `agent/proto/agent.proto` (+39/-9, API): `PluginBody` with nested `skills` and `mcp_servers`, and `Manifest.agent_plugins_enabled`. 3. `codersdk/workspacesdk/frontmatter.go` (+31/-0): `ValidatePluginName` and `MaxPluginNameLength` (manifest name grammar). 4. `coderd/database/queries/chats.sql`, `workspaceagentcontext.sql`, migration 000642 (+28/-7, DB): the `plugin_name` column on both context resource tables, copied by the hydrate, MCP sync, and re-pin queries. 5. `codersdk/agentsdk/agentsdk.go`, `agent/agent.go` (+18/-4, API): `Manifest.AgentPluginsEnabled` and `ConnectRPC217WithRole`; the agent dials v2.17. 6. `coderd/agentapi/api.go`, `manifest.go` (+4): the manifest flag follows the experiment. 7. `tailnet/proto/version.go` (+8/-1, API): Agent API v2.17. 8. `codersdk/deployment.go` (+4, API): the `agent-plugins` experiment. </details> <!-- pr-map:end --> --- This PR was generated by Coder Agents on behalf of @jscottmiller. Co-authored-by: Garrett Delfosse <delfossegarrett@gmail.com>
78 lines
2.0 KiB
SQL
78 lines
2.0 KiB
SQL
-- name: UpsertWorkspaceAgentContextSnapshot :one
|
|
INSERT INTO workspace_agent_context_snapshots (
|
|
workspace_agent_id,
|
|
version,
|
|
aggregate_hash,
|
|
snapshot_error,
|
|
received_at
|
|
) VALUES (
|
|
@workspace_agent_id,
|
|
@version,
|
|
@aggregate_hash,
|
|
@snapshot_error,
|
|
@received_at
|
|
)
|
|
ON CONFLICT (workspace_agent_id) DO UPDATE SET
|
|
version = EXCLUDED.version,
|
|
aggregate_hash = EXCLUDED.aggregate_hash,
|
|
snapshot_error = EXCLUDED.snapshot_error,
|
|
received_at = EXCLUDED.received_at
|
|
RETURNING *;
|
|
|
|
-- name: UpsertWorkspaceAgentContextResource :one
|
|
INSERT INTO workspace_agent_context_resources (
|
|
workspace_agent_id,
|
|
source,
|
|
body_kind,
|
|
body,
|
|
content_hash,
|
|
size_bytes,
|
|
status,
|
|
error,
|
|
source_path,
|
|
plugin_name,
|
|
created_at,
|
|
updated_at
|
|
) VALUES (
|
|
@workspace_agent_id,
|
|
@source,
|
|
@body_kind,
|
|
@body,
|
|
@content_hash,
|
|
@size_bytes,
|
|
@status,
|
|
@error,
|
|
@source_path,
|
|
@plugin_name,
|
|
@now,
|
|
@now
|
|
)
|
|
ON CONFLICT (workspace_agent_id, source) DO UPDATE SET
|
|
body_kind = EXCLUDED.body_kind,
|
|
body = EXCLUDED.body,
|
|
content_hash = EXCLUDED.content_hash,
|
|
size_bytes = EXCLUDED.size_bytes,
|
|
status = EXCLUDED.status,
|
|
error = EXCLUDED.error,
|
|
source_path = EXCLUDED.source_path,
|
|
plugin_name = EXCLUDED.plugin_name,
|
|
updated_at = EXCLUDED.updated_at
|
|
RETURNING *;
|
|
|
|
-- name: DeleteStaleWorkspaceAgentContextResources :exec
|
|
-- Deletes any resources for the agent whose source is not in the
|
|
-- supplied active set. Atomic alongside the snapshot upsert so the
|
|
-- stored snapshot and resource rows always agree.
|
|
DELETE FROM workspace_agent_context_resources
|
|
WHERE workspace_agent_id = @workspace_agent_id
|
|
AND NOT (source = ANY(@active_sources :: text[]));
|
|
|
|
-- name: GetLatestWorkspaceAgentContextSnapshot :one
|
|
SELECT * FROM workspace_agent_context_snapshots
|
|
WHERE workspace_agent_id = @workspace_agent_id;
|
|
|
|
-- name: ListWorkspaceAgentContextResources :many
|
|
SELECT * FROM workspace_agent_context_resources
|
|
WHERE workspace_agent_id = @workspace_agent_id
|
|
ORDER BY source ASC;
|