使用 config、actions、hooks、system text、availability、lifecycle 与可选 runtime HTTP routes 构建自定义 plugin

自定义 Plugin

如果你要加的东西主要是：

一组 actions
一组 hooks
一层 system text
一个生命周期拥有的 runtime 边界
一组 runtime HTTP routes

那自定义 plugin 通常就是合适的扩展点。

当前公开入口

@downcity/agent 已经公开了：

plugin 类型与契约
built-in plugin 导出
本地 Agent 的 plugins: [...] 组装入口

最小骨架

import type { Plugin } from "@downcity/agent";

export const notesPlugin: Plugin = {
  name: "notes",
  title: "Notes Helper",
  description: "Adds note-related actions and prompt guidance.",
  actions: {
    status: {
      execute: async ({ context }) => {
        return {
          success: true,
          data: {
            rootPath: context.rootPath,
          },
        };
      },
    },
  },
};

挂到本地 Agent 上

import { Agent, type Plugin } from "@downcity/agent";

const notesPlugin: Plugin = {
  name: "notes",
  title: "Notes Helper",
  description: "Adds note-related actions and runtime guidance.",
  actions: {
    status: {
      allowWhenDisabled: true,
      execute: async ({ context }) => ({
        success: true,
        data: {
          rootPath: context.rootPath,
        },
      }),
    },
  },
};

const agent = new Agent({
  id: "repo-helper",
  path: "/path/to/project",
  tools: {},
  plugins: [notesPlugin],
});