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

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

## role
Provides database seeding utilities to populate initial built-in tool type configurations for the API application.
## files
- __init__.py | Marks directory as Python package for database seeding utilities
- builtin_tool_types.py | Seeds built-in tool types (code-server, jupyter-notebook, opencode) into the database with Docker Compose templates, creating or updating records as needed. | 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 pattern with idempotent upsert operations, directly importing and executing database model creation logic with embedded Docker Compose template 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
-
