Function assistantToolDefs

app/src/AI/ToolDispatcher.cpp:372–427

* @brief Returns the snapshot/dataset/workspace tool schemas exposed under the assistant.* prefix. */

 * @brief Returns the snapshot/dataset/workspace tool schemas exposed under the assistant.* prefix.
 */
static QVector<detail::AssistantToolDef> assistantToolDefs()
{
  const auto scriptProps = scriptPropsBag();
  return {
    {QStringLiteral("assistant.snapshot"),
     QStringLiteral("Assistant-oriented project snapshot with resolved project structure, "
                    "workspaces, and a compact identity guide. Prefer this over chaining "
                    "project.snapshot + list calls."),
     snapshotInputSchema()},
    {QStringLiteral("assistant.dataset.resolve"),
     QStringLiteral("Resolve a dataset from human input. Accepts path, title, or uniqueId and "
                    "returns the canonical dataset object plus identity hints."),
     datasetInputSchema()},
    {QStringLiteral("assistant.workspace.resolve"),
     QStringLiteral("Resolve a workspace by title or id and return the canonical workspace row."),
     workspaceInputSchema()},
    {QStringLiteral("assistant.workspace.plan"),
     QStringLiteral("Read the current project and suggest workspace tile additions using "
                    "compatible widget slugs. This is read-only planning."),
     planInputSchema()},
    {QStringLiteral("assistant.workspace.addTile"),
     QStringLiteral("High-level workspace mutation: resolves workspace/group/dataset, enables "
                    "the matching dataset option when needed, patches optional ranges, turns "
                    "customize mode on, adds the widget, then verifies the workspace."),
     tileInputSchema()},
    {QStringLiteral("assistant.script.dryRun"),
     QStringLiteral("Validate script code on the right Serial Studio surface. Routes frame "
                    "parsers, transforms, painters, and end-to-end parser+transform checks to "
                    "the matching dry-run endpoint and returns actionable reference hints."),
     makeObjectSchema(scriptProps, QJsonArray{QStringLiteral("kind")})},
    {QStringLiteral("assistant.script.apply"),
     QStringLiteral("Dry-run script code first, then apply it to the correct project target. "
                    "Use for frame parsers, dataset transforms, and painter widgets."),
     makeObjectSchema(scriptProps, QJsonArray{QStringLiteral("kind"), QStringLiteral("code")})},
    {QStringLiteral("assistant.project.bulkApply"),
     QStringLiteral("Validate and execute a project.batch mutation, rejecting nested batches and "
                    "summarizing per-op failures so models do not loop individual edits."),
     bulkInputSchema()},
    {QStringLiteral("assistant.checkpoint"),
     QStringLiteral("Force an immediate project snapshot to disk and return its absolute path. "
                    "Call BEFORE any multi-step risky edit so you can roll back atomically with "
                    "assistant.restore if any subsequent step fails."),
     checkpointInputSchema()},
    {QStringLiteral("assistant.restore"),
     QStringLiteral("Restore a previously taken checkpoint, replacing the current project state. "
                    "Provide one of: path (absolute path), timestamp (ISO string from "
                    "assistant.listCheckpoints), or label. Returns reverseSnapshotPath so the "
                    "restore itself is reversible."),
     restoreInputSchema()},
    {QStringLiteral("assistant.listCheckpoints"),
     QStringLiteral("List the rolling backup snapshots for the currently loaded project, newest "
                    "first. Returns {checkpoints:[{path,timestamp,sizeBytes,label}],count,"
                    "directory}."),
     listCheckpointsInputSchema()},
  };
}

/**