How gust-feng/synech works
Synech is a local-first agent workspace. A user submits a conversation or attaches context in the panel; the server coordinates an ordinary-agent run, which uses model and tool capabilities, then exposes activity and results back to the panel. Separate product branches manage spaces and references, memory, and configuration/integrations. The sampled code confirms preview, context, memory, storage, and MCP behavior; some run orchestration and UI-to-server wiring are inferred from module names and package metadata, not inspected source.
Main entry points: index.ts Panel server · ordinary-routes.ts Conversation routes · App.tsx Workbench UI · ordinary-agent-feature.ts Agent coordinator
Components 23
Panel experience
- Workbench UI
src/app/panel-ui/src/App.tsx - Panel API client
src/app/panel-ui/src/api.ts - Panel server
src/app/panel-server/index.ts
Agent runtime
- Conversation routes
src/app/panel-server/ordinary/ordinary-routes.ts - Agent coordinator
src/app/ordinary-agent/ordinary-agent-feature.ts - Turn application
src/app/application/ordinary-turn-application.ts - Agent session loop
src/adapters/intelligence/agent-session-loop.ts - Model runtime
src/app/model-runtime/agent-loop.ts - Tool capabilities
src/app/capability/capability-center.ts - Session repository
src/adapters/intelligence/file-system-agent-session-repository.ts
Workspace content
- Context attachments
src/app/panel-server/workbench/context-routes.ts - Spaces and references
src/app/panel-server/spaces/space-routes.ts - Reference preview client
src/app/panel-ui/src/personal-workbench/workbench/app/components/referencePreviewClient.ts
Memory
- Memory routes
src/app/panel-server/routes-memory.ts - Agent memory routes
src/app/panel-server/ordinary/agent-memory-routes.ts - Memory feature
src/app/memory/memory-feature.ts
Configuration and integrations
- MCP manager
src/adapters/mcp/mcp-manager.ts - Configuration center
src/app/config-center/index.ts - Panel storage
src/app/panel-server/storage/panel-storage.ts - SQLite runtime database
src/adapters/runtime-storage/sqlite-runtime-database.ts
Other components
- User
- Model provider
- MCP servers
Connections 23
- User → Workbench UI: uses
- Workbench UI → Panel API client: requests
- Panel API client → Panel server: sends HTTP
- Panel server → Conversation routes: dispatches
- Conversation routes → Agent coordinator: coordinates runs
- Agent coordinator → Turn application: starts turns
- Turn application → Agent session loop: runs session
- Agent session loop → Model runtime: requests model
- Model runtime → Model provider: sends prompts
- Agent session loop → Tool capabilities: invokes tools
- Tool capabilities → MCP manager: offers MCP tools
- MCP manager → MCP servers: calls tools
- Conversation routes → Context attachments: handles attachments
- Workbench UI → Reference preview client: loads previews
- Reference preview client → Spaces and references: requests previews
- Panel server → Spaces and references: dispatches
- Panel server → Memory routes: dispatches
- Conversation routes → Agent memory routes: handles memory
- Memory routes → Memory feature: queries and mutates
- Agent memory routes → Memory feature: queries and mutates
- Panel server → Configuration center: serves settings
- Panel storage → SQLite runtime database: opens
- Agent coordinator → Session repository: uses sessions