mirror of
https://github.com/getpaseo/paseo.git
synced 2026-10-30 05:02:58 +00:00
Mohamed Boudra
986687b8fd
* refactor(plugins): make lifecycle hook timing explicit Use one registration method and subject.operation.step names so plugin authors can read whether an operation waits. Preserve old registrations through a single SDK adapter and keep timing and payloads unchanged. * fix(plugins): align hook notes and example fixtures with release contracts Keep the changelog inside its versioned beta entry for app parsing. Run current plugin examples against the checkout version so their declared requirements remain valid. * docs(plugins): align translated hook dependency guidance * fix(plugins): align hook exports and release documentation * feat(plugins): use lifecycle positions and await worktree initialization * test(plugins): cover first-agent worktree initialization * test(plugins): verify rollback against workspace catalog entries
34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
# Agent tools
|
|
|
|
Attaches `append_workspace_note` to agents whose `notes/enabled` label is `"true"`.
|
|
Calling the tool with `{ "note": "Run the targeted tests before committing." }` appends that
|
|
line to `AGENT_NOTES.md` in the calling agent's working directory and returns the file path.
|
|
It creates the file if it does not exist.
|
|
|
|
Install on a daemon with plugins enabled:
|
|
|
|
```bash
|
|
paseo plugin install /absolute/path/to/plugin-examples/agent-tools
|
|
```
|
|
|
|
Create a labeled agent through the SDK:
|
|
|
|
```ts
|
|
const agent = await paseo.agents.create({
|
|
config: { provider: "codex/gpt-5.4" },
|
|
cwd: "/projects/shop",
|
|
labels: { "notes/enabled": "true" },
|
|
});
|
|
```
|
|
|
|
The session-open callback also runs when an agent resumes or reloads. After changing an existing
|
|
agent's labels, call `paseo.agents.ref(id).reload()` to apply the selection immediately. This
|
|
interrupts a running turn. `refresh()` reads the agent snapshot without reopening its session.
|
|
|
|
From the repository root, `npm run typecheck` includes this example. Outside this repository,
|
|
use `paseo plugin init` to create the package and TypeScript setup, then copy `index.server.ts`
|
|
and the manifest into that project.
|
|
|
|
See [Attach tools to agents](../../public-docs/plugins/hooks.md#attach-tools-to-agents)
|
|
for targeting, execution, provider gates, collisions, and plugin reload behavior.
|