Contributing

vibes/
├── deno.json                  # Workspace root — tasks run across all packages
├── packages/
│   └── sdk/
│       ├── deno.json          # SDK package config, tasks, import map
│       ├── mod.ts             # Public exports entry point
│       ├── lib/               # Source code
│       │   ├── agent.ts       # Agent class
│       │   ├── tool.ts        # Tool factories (tool, plainTool, outputTool, fromSchema)
│       │   ├── types/         # Core types: errors, usage limits, results, events
│       │   ├── graph/         # Graph FSM: BaseNode, Graph, persistence
│       │   ├── execution/     # Internal run loop, streaming, deferred approvals
│       │   ├── toolsets/      # Toolset base class
│       │   ├── testing/       # Test utilities (TestModel, setAllowModelRequests)
│       │   └── ...
│       ├── community/         # Community toolsets (memory, skills, todo, etc.)
│       ├── tests/             # Integration and unit tests
│       ├── docs/              # Mintlify documentation source
│       └── skills/            # Agent skill files for Claude Code

# Clone the repo
git clone https://github.com/a7ul/vibes.git
cd vibes

# Run all tests across all packages (from repo root)
deno task test

# Run only the SDK tests (from packages/sdk)
cd packages/sdk
deno task test

cd packages/sdk
deno task build:npm

cd packages/sdk
deno task docs:dev
# Mintlify starts a local dev server at http://localhost:3000

deno task docs:build

deno fmt
deno lint

<type>: <short description>

<optional body>

feat: add MemoryStatePersistence for in-process graph state
fix: correct UsageLimitError limitKind type to include outputTokens
docs: add graph-patterns page to concepts

community/
└── my_toolset/
    ├── mod.ts          # Public exports
    ├── toolset.ts      # Toolset implementation
    └── toolset.test.ts # Tests