Open,
all the way down.

// plugin.ts: one tool, one hook, its own storage
import type { PluginExecute, PluginHooks, PluginTool }
  from "@frockbot/applet-sdk/plugin";

export const tools: PluginTool[] = [{
  name: "note_add",
  description: "Keep one short note for this Bot.",
  inputSchema: { type: "object",
    properties: { text: { type: "string" } },
    required: ["text"] },
}];

export const execute: PluginExecute = async (tool, input, ctx) => {
  const stored = await ctx.storage?.get({ key: "notes" });
  const notes = stored?.status === "available" ? stored.value : [];
  await ctx.storage?.put({ key: "notes", value: [...notes, input.text] });
  return `Kept it. ${notes.length + 1} note(s) now.`;
};

export const hooks: PluginHooks = {
  "agent/tool-exposure": (payload) =>
    payload.tools.filter((t) => t.name !== "image_generate"),
};

1. 1system-prompt/assemble add to or rewrite the prompt before the model sees it
2. 2agent/tool-exposure hide, rename or add tools for this Turn
3. 3agent/request change the messages or the options on each request
4. 4tools/pre-execute inspect or veto a tool call before it runs
5. 5tools/post-execute reshape a result before it reaches the model
6. 6agent/turn-stopping receive the notification that the Turn is stopping