How c4rohan/lampline works
Lampline is a local-first platform for authoring, testing, and running phone agents, including Dialogflow CX and CX Agent Studio imports and exports. The main workflow is to keep an agent as YAML/Markdown, lint and test it with vk, then run conversations through the engine and optionally connect phone services. The graph also preserves the builder, evaluations, integrations, knowledge, tools, and triggers described by the README. Some subsystem links rely on README documentation because their implementation was not sampled.
Main entry points: server.py Engine API · cli.py vk CLI · session.py Conversation session · agentfs.py Agent files
Components 24
Agent authoring
- Agent files
cli/src/vk/agentfs.py - vk CLI
cli/src/vk/cli.py - Agent lint
cli/src/vk/lint.py - Scenario tests
cli/src/vk/scenario.py - Google importers
cli/src/vk/importers - Google exporters
cli/src/vk/exporters
Conversation engine
- Engine API
engine/src/vpengine/server.py - Agent graph
engine/src/vpengine/graph.py - Conversation session
engine/src/vpengine/session.py - Flow controller
engine/src/vpengine/flow.py - Model and speech
engine/src/vpengine/services.py
Calls and evaluation
- Phone transports
engine/src/vpengine/twilio.py - Phone evaluations
engine/src/vpengine/evals.py - Triggers and automation
engine/src/vpengine/automation.py - Phone Bridge
extension/gv-page.js
Integrations and data
- Agent tools
engine/src/vpengine/tools.py - Connectors
engine/src/vpengine/connectors.py - Knowledge store
engine/src/vpengine/library.py
User interfaces
- Visual builder
engine/ui/src/builder - Integrations settings
engine/ui/src/pages/Integrations.tsx - Web application
engine/ui/src/App.tsx
Other components
- Agent author
- Phone network
- Model providers
Connections 29
- Agent author → Agent files: authors
README.md - Agent author → vk CLI: runs commands
README.md - vk CLI → Agent files: reads and writes
cli/src/vk/cli.py - vk CLI → Agent lint: runs checks
cli/src/vk/cli.py - vk CLI → Scenario tests: runs tests
cli/src/vk/cli.py - vk CLI → Google importers: imports agents
cli/src/vk/cli.py - vk CLI → Google exporters: exports agents
cli/src/vk/cli.py - Google importers → Agent files: produces agent
cli/src/vk/importers/common.py - Google exporters → Agent files: reads agent
cli/src/vk/exporters/common.py - vk CLI → Engine API: tests against
- Engine API → Agent graph: loads agents
engine/src/vpengine/server.py - Engine API → Conversation session: starts sessions
engine/src/vpengine/server.py - Conversation session → Flow controller: delegates turns
engine/src/vpengine/session.py - Conversation session → Agent graph: uses graph
engine/src/vpengine/session.py - Conversation session → Model and speech: uses services
engine/src/vpengine/session.py - Flow controller → Agent tools: invokes tools
- Engine API → Phone transports: serves phone calls
engine/src/vpengine/server.py - Model and speech → Model providers: connects models
README.md - Engine API → Phone evaluations: supports evaluations
engine/src/vpengine/server.py - Phone evaluations → Phone network: places eval calls
README.md - Phone Bridge → Phone evaluations: bridges call audio
README.md - Engine API → Triggers and automation: runs triggers
engine/src/vpengine/server.py - Triggers and automation → Connectors: checks status
engine/src/vpengine/automation.py - Agent tools → Connectors: uses connectors
- Engine API → Knowledge store: serves data collections
engine/src/vpengine/server.py - Web application → Engine API: uses API
- Visual builder → Engine API: edits agents
- Integrations settings → Engine API: configures services
- Phone network → Phone transports: carries calls