# apps/api/src/seeds
dir: apps/api/src/seeds

index: apps/api/src/seeds/.pi-map.index.md

## role
Database seeding utilities for populating initial data, specifically built-in tool types.
## files
- __init__.py | Marks the directory as a Python package for database seeding utilities.
- builtin_tool_types.py | Seeds built-in Docker Compose-based tool types (VS Code Server, Jupyter Notebook, OpenCode) into a database with idempotent create-or-update logic. | exp: func:_table_exists(session, table_name: str) → bool, call:session.execute, call:text, call:result.scalar, func:seed_builtin_tool_types(), call:SessionLocal, call:_table_exists, call:logger.warning, call:session.scalar, call:select(ToolType).where, call:ToolType, call:tool_data.get, call:session.add, call:logger.info, call:session.commit | dep: logging, sqlalchemy, src.database, src.models
## arch
Simple procedural seeding scripts with idempotent create-or-update logic for Docker Compose-based tool definitions.
## tags
tool, types, table, exists, builtin, call:tool, database, init
## symbols
- _table_exists
- seed_builtin_tool_types
- call:session.execute
- call:text
- call:result.scalar
- call:SessionLocal
- call:_table_exists
- call:logger.warning
## workflows
- change seeds behavior
  read: __init__.py, builtin_tool_types.py
## dirty
-
