mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-10-03 09:14:12 +02:00
ispyisail
2fb14c5bd0
A new setting, Configurer QElectroTech > Général > "Autoriser un assistant IA à agir sur le projet ouvert", off by default. Off, nothing changes: no channel is opened. On, every start shows a warning first -- Continuer, Pas pour cette session, or Désactiver -- and nothing can connect until the user answers Continuer. It waits for any other start-up question to be answered, so the two never stack. Accepted, LiveServer opens a local socket only the user's account can use, with a random name and token written to live-session.json in the data folder for the qet MCP server, and removed when the channel closes. One JSON request per line: status (project, folio on screen, selection, last undo step, stored scripts), run_script and run_stored. Requests are queued out of the socket handler before they run (the lesson of PR #861). Each run is one undo step named "Assistant : <name>". The status bar shows the mode and the assistant's last action with a ✓ or ✗ and the time, and an Arrêter button that closes the channel for the session. Unticking the setting closes it at once. QetScripting::runSource() runs script text and, for a live run, returns what qet.log() wrote, the error with its line and the undo step instead of showing boxes; qet.showMessage() is logged rather than opening a box nobody asked for. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
92 lines
3.1 KiB
C++
92 lines
3.1 KiB
C++
/*
|
|
Copyright 2006-2026 The QElectroTech Team
|
|
This file is part of QElectroTech.
|
|
|
|
QElectroTech is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
QElectroTech is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with QElectroTech. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
#ifndef QET_SCRIPTING_H
|
|
#define QET_SCRIPTING_H
|
|
|
|
#include <QStringList>
|
|
|
|
class QETProject;
|
|
class DiagramView;
|
|
|
|
/**
|
|
@brief JavaScript scripting entry points (bugtracker #162).
|
|
|
|
A script sees a single global, `qet` (see QetScriptApi): reading the
|
|
model, exporting, editing geometry through the real undo commands, and
|
|
a narrow set of navigation/messaging calls. See QetScriptApi's class
|
|
comment for the exact scope and why each group of capability stops
|
|
where it does.
|
|
*/
|
|
namespace QetScripting {
|
|
|
|
/**
|
|
@brief True if @p args is a `--run <script.js> <project.qet>`
|
|
invocation.
|
|
*/
|
|
bool isRunRequest(const QStringList &args);
|
|
|
|
/**
|
|
@brief Run the script named in @p args against the project also
|
|
named there, headless.
|
|
Usage: qelectrotech --run <script.js> <project.qet>
|
|
@return process exit code: 0 on success, 1 if the project failed to
|
|
open or the script threw, 2 on a usage error.
|
|
*/
|
|
int run(const QStringList &args);
|
|
|
|
/**
|
|
@brief Run @p scriptPath against an already-open @p project (the
|
|
"Run Script..." GUI macro path). Errors go to stderr, and with a
|
|
@p view also to a message box. With a @p view the whole run is one
|
|
undo step; without one, each call is its own step, as on --run.
|
|
@param view the active DiagramView, so the script's zoom methods
|
|
have something to act on; nullptr from the headless entry point,
|
|
where they become no-ops (see QetScriptApi).
|
|
@param title what the undo step is called; the script's file name
|
|
if empty.
|
|
@return true if the script ran without throwing.
|
|
*/
|
|
bool runOnProject(const QString &scriptPath, QETProject *project, DiagramView *view = nullptr,
|
|
const QString &title = QString());
|
|
|
|
/**
|
|
@brief What a live run (an assistant acting on the open project,
|
|
see LiveServer) reports instead of showing: what the script
|
|
logged, the error if it threw, and the undo step it left, empty
|
|
if it changed nothing.
|
|
*/
|
|
struct LiveRun
|
|
{
|
|
QStringList log;
|
|
QString error;
|
|
QString undoText;
|
|
};
|
|
|
|
/**
|
|
@brief Run @p source as runOnProject() runs a file. @p fileName is
|
|
what errors name; @p title names the undo step. With @p live, no
|
|
box is shown: qet.log() and errors are collected there, and
|
|
qet.showMessage() is logged rather than shown.
|
|
*/
|
|
bool runSource(const QString &source, const QString &fileName, const QString &title,
|
|
QETProject *project, DiagramView *view, LiveRun *live);
|
|
|
|
}
|
|
|
|
#endif // QET_SCRIPTING_H
|