Files
Yeuoly 888ad788bc refactor: plugin lifecycle control panel (#499)
* refactor: introduce local plugin control panel and cleanup environment setup process

* fix: args

* refactor: new local runtime

* temp: stash work for refactor on RemotePluginServer

* refactor: unify local runtime lifetime and sperate init environment process

* chore: add missing files

* stash

* refactor: local plugin lifetime control

* refactor: complete installation process of control panel

* refactor: adapt service layer to new controlpanel

* refactor: pluginManager.Install

* fix: add routine wrap to InstallServerless, avoid blocking main thread

* feat: reinstall serverless runtime

* chore: add comments to Reinstall and update confusing naming

* refactor: unify install plugin service

* refactor: add labels to debugging runtime

* refactor: add getters to plugin manager

* refactor: split install service to decode/install_task/install service

* ???

* refactor: adapt controllers

* refactor: session write

* refactor: session runtime

* Refine install task orchestration (#501)

* refactor: installing task

* refactor cluster management, decouple lifetime management and cluster

* fix cli test command

* fix: cleanup TODO comments and implement GracefulStop for instance

* feat: add logger to control panel

* fix: multiple nil references

* refactor: better lifetime control

* refactor: better cycle interval

* fix(LocalPluginRuntime): prevent returning err when it's not  error

* fix: avoid adding empty PipExtraArgs

* fix: missing errors in Environment init

* fix: add truncateMessage to avoid db explosion

* cleanup: better lifecycle management

* fix: init status at the beginning of installation

* optimize: GracefulStop for pluginInstance

* refactor: tests

* refactor: centralize routine labels (#504)

* cleanup: RoutineKey

* fix: init routine pool

* fix: correctly handle cluster register error

* fix: memory leak

* fix: add \n to instance write

* fix(installer.go): set success to true after succeed for defer func

* refactor

* fix: missing cwd in testutils

* fix: scaleup default runtime nums to 1 when testing

* fix: localruntime appconfig in testing module

* Update internal/core/local_runtime/load_balancing.go

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* fix: more efficiency implement in installer_local.go

* fix: returns after failing in onDebuggingRuntimeDisconnected

* fix: returns after failing in onDebuggingRuntimeDisconnected

* fix: splits tests

* refactor: naming

* refactor: manifest.VersionX

* fix: adapt SetDefault to tests

* fix: enforce use constants in DBType

* fix: generate

* fix: linter

* cleanup tests

* refactor: change  package to

* cleanup: useless codes

* Update internal/cluster/plugin.go

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* cleanup

* refactor: decouple connection_key management from debugging_time

* refactor: confused naming

* feat: recycle resources to adapt to https://github.com/langgenius/dify-plugin-daemon/pull/500

* refactor: confusing redirecting

* fix: support get serverless runtime

* fix: race condition in Launching

* fix: avoid ManifestValidate in first step of debugging handshake

* fix: adding ReleaseAllLocks to finalizers

* wtf: what a beautiful code

* refactor: rename Stream.Async to Stream.Process

* fix: kill process if daed instance was detected

* fix: correctly handle failures

* fix: consistence of difference interfaces

* fix: add stacktrace to panic

* fix: only trigger once  event

* fix: ensure plugin runtime was shutdown

* feat: cleanup install tasks

* fix: add scale logs

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2025-11-18 17:28:02 +08:00

291 lines
8.4 KiB
Go

package run
import (
"bufio"
"errors"
"fmt"
"os"
"os/signal"
"syscall"
"github.com/google/uuid"
"github.com/langgenius/dify-plugin-daemon/internal/core/dify_invocation/mock"
"github.com/langgenius/dify-plugin-daemon/internal/core/local_runtime"
"github.com/langgenius/dify-plugin-daemon/internal/core/session_manager"
"github.com/langgenius/dify-plugin-daemon/internal/core/testutils"
"github.com/langgenius/dify-plugin-daemon/pkg/entities/plugin_entities"
"github.com/langgenius/dify-plugin-daemon/pkg/plugin_packager/decoder"
"github.com/langgenius/dify-plugin-daemon/pkg/utils/log"
"github.com/langgenius/dify-plugin-daemon/pkg/utils/parser"
"github.com/langgenius/dify-plugin-daemon/pkg/utils/routine"
"github.com/langgenius/dify-plugin-daemon/pkg/utils/stream"
)
func logResponse(response GenericResponse, responseFormat string, client client) {
var responseBytes []byte
if responseFormat == "json" {
responseBytes = parser.MarshalJsonBytes(response)
} else if responseFormat == "text" {
responseBytes = []byte(fmt.Sprintf("[%s] %s\n", response.Type, response.Response))
}
// add a newline to the response
responseBytes = append(responseBytes, '\n')
if _, err := client.writer.Write(responseBytes); err != nil {
systemLog(GenericResponse{
Type: GENERIC_RESPONSE_TYPE_ERROR,
Response: map[string]any{"error": err.Error()},
}, responseFormat)
}
}
func systemLog(response GenericResponse, responseFormat string) {
if responseFormat == "json" {
responseBytes := parser.MarshalJsonBytes(response)
fmt.Println(string(responseBytes))
} else if responseFormat == "text" {
switch response.Type {
case GENERIC_RESPONSE_TYPE_INFO:
logger.Output(3, log.LOG_LEVEL_DEBUG_COLOR+"[INFO]"+response.Response["info"].(string)+log.LOG_LEVEL_COLOR_END)
case GENERIC_RESPONSE_TYPE_ERROR:
logger.Output(3, log.LOG_LEVEL_ERROR_COLOR+"[ERROR]"+response.Response["error"].(string)+log.LOG_LEVEL_COLOR_END)
}
}
}
func handleClient(
client client,
declaration *plugin_entities.PluginDeclaration,
runtime *local_runtime.LocalPluginRuntime,
responseFormat string,
) {
// handle request from client
scanner := bufio.NewScanner(client.reader)
scanner.Buffer(make([]byte, 1024*1024), 15*1024*1024)
// generate a random user id, tenant id and cluster id
userID := uuid.New().String()
tenantID := uuid.New().String()
clusterID := uuid.New().String()
// runtime.Identity() has already been checked in RunPlugin
pluginUniqueIdentifier, _ := runtime.Identity()
// mocked invocation
mockedInvocation := mock.NewMockedDifyInvocation()
logResponse(GenericResponse{
Type: GENERIC_RESPONSE_TYPE_PLUGIN_READY,
Response: map[string]any{"info": "plugin loaded"},
}, responseFormat, client)
for scanner.Scan() {
payload := scanner.Bytes()
logResponse(GenericResponse{
Type: GENERIC_RESPONSE_TYPE_INFO,
Response: map[string]any{"info": "received request"},
}, responseFormat, client)
invokePayload, err := parser.UnmarshalJsonBytes[InvokePluginPayload](payload)
if err != nil {
logResponse(GenericResponse{
InvokeID: invokePayload.InvokeID,
Type: GENERIC_RESPONSE_TYPE_ERROR,
Response: map[string]any{"error": err.Error()},
}, responseFormat, client)
continue
}
if invokePayload.Action == "" || invokePayload.Type == "" {
logResponse(GenericResponse{
InvokeID: invokePayload.InvokeID,
Type: GENERIC_RESPONSE_TYPE_ERROR,
Response: map[string]any{"error": "action and type are required"},
}, responseFormat, client)
continue
}
session := session_manager.NewSession(
session_manager.NewSessionPayload{
UserID: userID,
TenantID: tenantID,
PluginUniqueIdentifier: pluginUniqueIdentifier,
ClusterID: clusterID,
InvokeFrom: invokePayload.Type,
Action: invokePayload.Action,
Declaration: declaration,
BackwardsInvocation: mockedInvocation,
IgnoreCache: true,
},
)
stream, err := testutils.RunOnceWithSession[map[string]any, map[string]any](
runtime,
session,
invokePayload.Request,
)
if err != nil {
logResponse(GenericResponse{
InvokeID: invokePayload.InvokeID,
Type: GENERIC_RESPONSE_TYPE_ERROR,
Response: map[string]any{"error": err.Error()},
}, responseFormat, client)
continue
}
routine.Submit(nil, func() {
for stream.Next() {
response, err := stream.Read()
if err != nil {
logResponse(GenericResponse{
InvokeID: invokePayload.InvokeID,
Type: GENERIC_RESPONSE_TYPE_ERROR,
Response: map[string]any{"error": err.Error()},
}, responseFormat, client)
continue
}
logResponse(GenericResponse{
InvokeID: invokePayload.InvokeID,
Type: GENERIC_RESPONSE_TYPE_PLUGIN_RESPONSE,
Response: response,
}, responseFormat, client)
}
logResponse(GenericResponse{
InvokeID: invokePayload.InvokeID,
Type: GENERIC_RESPONSE_TYPE_PLUGIN_INVOKE_END,
Response: map[string]any{"info": "plugin invoke end"},
}, responseFormat, client)
})
}
}
func RunPlugin(payload RunPluginPayload) {
if err := runPlugin(payload); err != nil {
systemLog(GenericResponse{
Type: GENERIC_RESPONSE_TYPE_ERROR,
Response: map[string]any{"error": err.Error()},
}, payload.ResponseFormat)
os.Exit(1)
}
}
func setupSignalHandler(dir string) {
signalChanInterrupt := make(chan os.Signal, 1)
signalChanTerminate := make(chan os.Signal, 1)
signalChanKill := make(chan os.Signal, 1)
signal.Notify(signalChanInterrupt, os.Interrupt)
signal.Notify(signalChanTerminate, syscall.SIGTERM)
signal.Notify(signalChanKill, os.Interrupt)
go func() {
select {
case <-signalChanInterrupt:
case <-signalChanTerminate:
case <-signalChanKill:
}
os.RemoveAll(dir)
os.Exit(0)
}()
}
func runPlugin(payload RunPluginPayload) error {
// disable logs
log.SetLogVisibility(payload.EnableLogs)
// init routine pool
routine.InitPool(10000)
// generate a random cwd
tempDir := os.TempDir()
dir, err := os.MkdirTemp(tempDir, "plugin-run-*")
if err != nil {
return errors.Join(err, fmt.Errorf("create temp directory error"))
}
defer testutils.ClearTestingPath(dir)
// remove the temp directory when the program shuts down
setupSignalHandler(dir)
// try decode the plugin zip file
pluginFile, err := os.ReadFile(payload.PluginPath)
if err != nil {
return errors.Join(err, fmt.Errorf("read plugin file error"))
}
zipDecoder, err := decoder.NewZipPluginDecoder(pluginFile)
if err != nil {
return errors.Join(err, fmt.Errorf("decode plugin file error"))
}
// get the declaration of the plugin
declaration, err := zipDecoder.Manifest()
if err != nil {
return errors.Join(err, fmt.Errorf("get declaration error"))
}
systemLog(GenericResponse{
Type: GENERIC_RESPONSE_TYPE_INFO,
Response: map[string]any{"info": "loading plugin"},
}, payload.ResponseFormat)
// launch the plugin locally and returns a local runtime
runtime, err := testutils.GetRuntime(pluginFile, dir, 1)
if err != nil {
return err
}
// check the identity of the plugin
_, err = runtime.Identity()
if err != nil {
return err
}
var stream *stream.Stream[client]
switch payload.RunMode {
case RUN_MODE_STDIO:
// create a stream of clients that are connected to the plugin through stdin and stdout
// NOTE: for stdio, there will only be one client and the stream will never close
stream = createStdioServer()
case RUN_MODE_TCP:
// create a stream of clients that are connected to the plugin through a TCP connection
// NOTE: for tcp, there will be multiple clients and the stream will close when the client is closed
stream, err = createTCPServer(&payload)
if err != nil {
return err
}
systemLog(GenericResponse{
Type: GENERIC_RESPONSE_TYPE_INFO,
Response: map[string]any{
"info": fmt.Sprintf("plugin is running on %s:%d", payload.TcpServerHost, payload.TcpServerPort),
"host": payload.TcpServerHost,
"port": payload.TcpServerPort,
},
}, payload.ResponseFormat)
default:
return fmt.Errorf("invalid run mode: %s", payload.RunMode)
}
// start a routine to handle the client stream
for stream.Next() {
client, err := stream.Read()
if err != nil {
systemLog(GenericResponse{
Type: GENERIC_RESPONSE_TYPE_ERROR,
Response: map[string]any{"error": err.Error()},
}, payload.ResponseFormat)
continue
}
routine.Submit(nil, func() {
handleClient(client, &declaration, runtime, payload.ResponseFormat)
})
}
return nil
}