10#include "absl/flags/declare.h"
11#include "absl/flags/flag.h"
12#include "absl/status/status.h"
13#include "absl/strings/ascii.h"
14#include "absl/strings/match.h"
15#include "absl/strings/str_cat.h"
16#include "absl/strings/str_format.h"
17#include "absl/strings/str_join.h"
18#include "absl/strings/string_view.h"
19#include "absl/time/clock.h"
20#include "absl/time/time.h"
50 std::string format =
"json";
52 std::string version =
"0.1.0";
60 auto project_status = project.
Open(
".");
62 if (project_status.ok()) {
63 std::cout <<
"š Loaded project: " << project.
name <<
"\n";
68 if (labels_status.ok()) {
69 std::cout <<
"ā
Embedded labels initialized (all Zelda3 resources "
77 std::cout <<
"š·ļø Loaded custom labels from: "
86 label_mgr->labels_loaded_ =
true;
87 std::cout <<
"š·ļø Using embedded Zelda3 labels (rooms, sprites, "
88 "entrances, items, etc.)\n";
93 std::cout <<
"ā¹ļø No project file found. Using embedded default Zelda3 "
98 return absl::OkStatus();
103 return absl::OkStatus();
106 std::string rom_path = absl::GetFlag(FLAGS_rom);
107 if (rom_path.empty()) {
108 return absl::FailedPreconditionError(
109 absl::StrFormat(
"No ROM loaded. Pass --rom=<path> when running %s.\n"
110 "Example: z3ed %s --rom=zelda3.sfc",
117 return absl::FailedPreconditionError(absl::StrFormat(
118 "Failed to load ROM from '%s': %s", rom_path, status.message()));
121 return absl::OkStatus();
125 const std::vector<std::string>& args) {
127 for (
size_t i = 0; i < args.size(); ++i) {
128 const std::string& token = args[i];
129 std::string flag = token;
130 std::optional<std::string> inline_value;
132 if (absl::StartsWith(token,
"--")) {
133 auto eq_pos = token.find(
'=');
134 if (eq_pos != std::string::npos) {
135 flag = token.substr(0, eq_pos);
136 inline_value = token.substr(eq_pos + 1);
141 [&](absl::string_view flag_name) -> absl::StatusOr<std::string> {
142 if (inline_value.has_value()) {
143 return *inline_value;
145 if (i + 1 >= args.size()) {
146 return absl::InvalidArgumentError(
147 absl::StrFormat(
"Flag %s requires a value", flag_name));
152 if (flag ==
"--resource") {
154 options.
resource = std::move(value);
155 }
else if (flag ==
"--format") {
157 options.
format = std::move(value);
158 }
else if (flag ==
"--output") {
161 }
else if (flag ==
"--version") {
163 options.
version = std::move(value);
164 }
else if (flag ==
"--last-updated") {
168 return absl::InvalidArgumentError(
169 absl::StrFormat(
"Unknown flag for agent describe: %s", token));
174 if (options.
format !=
"json" && options.
format !=
"yaml") {
175 return absl::InvalidArgumentError(
"--format must be either json or yaml");
185 if (arg_vec.size() < 2 || arg_vec[0] !=
"--prompt") {
186 return absl::InvalidArgumentError(
"Usage: agent run --prompt <prompt>");
188 std::string prompt = arg_vec[1];
190 RETURN_IF_ERROR(EnsureRomLoaded(rom,
"agent run --prompt \"<prompt>\""));
198 auto response_or = ai_service->GenerateResponse(prompt);
199 if (!response_or.ok()) {
200 return response_or.status();
204 return absl::FailedPreconditionError(
205 "Agent response did not include any executable commands.");
208 std::string provider = absl::GetFlag(FLAGS_ai_provider);
220 const auto& metadata = proposal_result.metadata;
221 std::filesystem::path proposal_dir = metadata.log_path.parent_path();
224 <<
"ā
Agent successfully planned and executed changes in a sandbox."
226 std::cout <<
" Proposal ID: " << metadata.id << std::endl;
227 std::cout <<
" Sandbox ROM: " << metadata.sandbox_rom_path << std::endl;
228 std::cout <<
" Proposal dir: " << proposal_dir << std::endl;
229 std::cout <<
" Diff file: " << metadata.diff_path << std::endl;
230 std::cout <<
" Log file: " << metadata.log_path << std::endl;
231 std::cout <<
" Proposal JSON: " << proposal_result.proposal_json_path
233 std::cout <<
" Commands executed: " << proposal_result.executed_commands
235 std::cout <<
" Tile16 changes: " << proposal_result.change_count
237 std::cout <<
"\nTo review the changes, run:\n";
238 std::cout <<
" z3ed agent diff --proposal-id " << metadata.id << std::endl;
239 std::cout <<
"\nTo accept the changes, run:\n";
240 std::cout <<
" z3ed agent accept --proposal-id " << metadata.id << std::endl;
242 return absl::OkStatus();
246 if (arg_vec.size() < 2 || arg_vec[0] !=
"--prompt") {
247 return absl::InvalidArgumentError(
"Usage: agent plan --prompt <prompt>");
249 std::string prompt = arg_vec[1];
252 auto response_or = ai_service->GenerateResponse(prompt);
253 if (!response_or.ok()) {
254 return response_or.status();
256 std::vector<std::string> commands = response_or.value().commands;
262 if (!proposal_or.ok()) {
263 return proposal_or.status();
265 auto proposal = proposal_or.value();
268 auto plans_dir = registry.RootDirectory() /
"plans";
270 std::filesystem::create_directories(plans_dir, ec);
272 return absl::InternalError(
273 absl::StrCat(
"Failed to create plans directory: ", ec.message()));
276 auto plan_path = plans_dir / (proposal.id +
".json");
277 auto save_status = generator.
SaveProposal(proposal, plan_path.string());
278 if (!save_status.ok()) {
282 std::cout <<
"AI Agent Plan (Proposal ID: " << proposal.id <<
"):\n";
283 std::cout << proposal.ToJson() << std::endl;
284 std::cout <<
"\nā
Plan saved to: " << plan_path.string() << std::endl;
286 return absl::OkStatus();
290 std::optional<std::string> proposal_id;
291 for (
size_t i = 0; i < args.size(); ++i) {
292 const std::string& token = args[i];
293 if (absl::StartsWith(token,
"--proposal-id=")) {
294 proposal_id = token.substr(14);
295 }
else if (token ==
"--proposal-id" && i + 1 < args.size()) {
296 proposal_id = args[i + 1];
302 absl::StatusOr<ProposalRegistry::ProposalMetadata> proposal_or;
303 if (proposal_id.has_value()) {
304 proposal_or = registry.GetProposal(proposal_id.value());
306 proposal_or = registry.GetLatestPendingProposal();
309 if (proposal_or.ok()) {
310 const auto& proposal = proposal_or.value();
312 std::cout <<
"\n=== Proposal Diff ===\n";
313 std::cout <<
"Proposal ID: " << proposal.id <<
"\n";
314 std::cout <<
"Sandbox ID: " << proposal.sandbox_id <<
"\n";
315 std::cout <<
"Prompt: " << proposal.prompt <<
"\n";
316 std::cout <<
"Description: " << proposal.description <<
"\n";
317 std::cout <<
"Status: ";
318 switch (proposal.status) {
320 std::cout <<
"Pending";
323 std::cout <<
"Accepted";
326 std::cout <<
"Rejected";
330 std::cout <<
"Created: " << absl::FormatTime(proposal.created_at) <<
"\n";
331 std::cout <<
"Commands Executed: " << proposal.commands_executed <<
"\n";
332 std::cout <<
"Bytes Changed: " << proposal.bytes_changed <<
"\n\n";
334 if (!proposal.sandbox_rom_path.empty()) {
335 std::cout <<
"Sandbox ROM: " << proposal.sandbox_rom_path <<
"\n";
337 std::cout <<
"Proposal directory: " << proposal.log_path.parent_path()
339 std::cout <<
"Diff file: " << proposal.diff_path <<
"\n";
340 std::cout <<
"Log file: " << proposal.log_path <<
"\n\n";
342 if (std::filesystem::exists(proposal.diff_path)) {
343 std::cout <<
"--- Diff Content ---\n";
344 std::ifstream diff_file(proposal.diff_path);
345 if (diff_file.is_open()) {
347 while (std::getline(diff_file, line)) {
348 std::cout << line <<
"\n";
351 std::cout <<
"(Unable to read diff file)\n";
354 std::cout <<
"(No diff file found)\n";
357 std::cout <<
"\n--- Execution Log ---\n";
358 if (std::filesystem::exists(proposal.log_path)) {
359 std::ifstream log_file(proposal.log_path);
360 if (log_file.is_open()) {
363 while (std::getline(log_file, line)) {
364 std::cout << line <<
"\n";
366 if (line_count > 50) {
367 std::cout <<
"... (log truncated, see " << proposal.log_path
368 <<
" for full output)\n";
373 std::cout <<
"(Unable to read log file)\n";
376 std::cout <<
"(No log file found)\n";
379 std::cout <<
"\n=== Next Steps ===\n";
380 std::cout <<
"To accept changes: z3ed agent commit\n";
381 std::cout <<
"To reject changes: z3ed agent revert\n";
382 std::cout <<
"To review in GUI: yaze --proposal=" << proposal.id <<
"\n";
384 return absl::OkStatus();
389 if (!sandbox_or.ok()) {
390 return absl::NotFoundError(
391 "No pending proposals found and no active sandbox. Run 'z3ed agent "
396 auto status = absl::UnimplementedError(
397 "RomDiff not yet implemented in new CommandHandler system");
402 return absl::AbortedError(
"No ROM loaded.");
404 return absl::OkStatus();
409 static bool initialized =
false;
414 std::cerr <<
"Failed to initialize learned knowledge service: "
415 << status.message() << std::endl;
423 std::cout <<
"\nUsage: z3ed agent learn [options]\n\n";
424 std::cout <<
"Options:\n";
425 std::cout <<
" --preference <key>=<value> Set a preference\n";
426 std::cout <<
" --get-preference <key> Get a preference value\n";
427 std::cout <<
" --list-preferences List all preferences\n";
428 std::cout <<
" --pattern <type> --data <json> Learn a ROM pattern\n";
429 std::cout <<
" --query-patterns <type> Query learned patterns\n";
430 std::cout <<
" --project <name> --context <text> Save project context\n";
431 std::cout <<
" --get-project <name> Get project context\n";
432 std::cout <<
" --list-projects List all projects\n";
434 <<
" --memory <topic> --summary <text> Store conversation memory\n";
435 std::cout <<
" --search-memories <query> Search memories\n";
436 std::cout <<
" --recent-memories [limit] Show recent memories\n";
437 std::cout <<
" --export <file> Export all data to JSON\n";
438 std::cout <<
" --import <file> Import data from JSON\n";
439 std::cout <<
" --stats Show statistics\n";
440 std::cout <<
" --clear Clear all learned data\n";
441 return absl::OkStatus();
445 std::string command = args[0];
447 if (command ==
"--preference" && args.size() >= 2) {
448 std::string pref = args[1];
449 size_t eq_pos = pref.find(
'=');
450 if (eq_pos == std::string::npos) {
451 return absl::InvalidArgumentError(
452 "Preference must be in format key=value");
454 std::string key = pref.substr(0, eq_pos);
455 std::string value = pref.substr(eq_pos + 1);
458 std::cout <<
"ā Preference '" << key <<
"' set to '" << value <<
"'\n";
463 if (command ==
"--get-preference" && args.size() >= 2) {
466 std::cout << args[1] <<
" = " << *value <<
"\n";
468 std::cout <<
"Preference '" << args[1] <<
"' not found\n";
470 return absl::OkStatus();
473 if (command ==
"--list-preferences") {
476 std::cout <<
"No preferences stored.\n";
478 std::cout <<
"\n=== Stored Preferences ===\n";
479 for (
const auto& [key, value] : prefs) {
480 std::cout <<
" " << key <<
" = " << value <<
"\n";
483 return absl::OkStatus();
486 if (command ==
"--stats") {
487 auto stats = learn_service.
GetStats();
488 std::cout <<
"\n=== Learned Knowledge Statistics ===\n";
490 std::cout <<
" ROM Patterns: " << stats.pattern_count <<
"\n";
491 std::cout <<
" Projects: " << stats.project_count <<
"\n";
492 std::cout <<
" Memories: " << stats.memory_count <<
"\n";
493 std::cout <<
" First learned: "
494 << absl::FormatTime(absl::FromUnixMillis(stats.first_learned_at))
496 std::cout <<
" Last updated: "
497 << absl::FormatTime(absl::FromUnixMillis(stats.last_updated_at))
499 return absl::OkStatus();
502 if (command ==
"--export" && args.size() >= 2) {
505 return json.status();
507 std::ofstream file(args[1]);
508 if (!file.is_open()) {
509 return absl::InternalError(
"Failed to open file for writing");
512 std::cout <<
"ā Exported learned data to " << args[1] <<
"\n";
513 return absl::OkStatus();
516 if (command ==
"--import" && args.size() >= 2) {
517 std::ifstream file(args[1]);
518 if (!file.is_open()) {
519 return absl::NotFoundError(
"File not found: " + args[1]);
521 std::stringstream buffer;
522 buffer << file.rdbuf();
525 std::cout <<
"ā Imported learned data from " << args[1] <<
"\n";
530 if (command ==
"--clear") {
531 auto status = learn_service.
ClearAll();
533 std::cout <<
"ā All learned data cleared\n";
538 if (command ==
"--list-projects") {
540 if (projects.empty()) {
541 std::cout <<
"No projects stored.\n";
543 std::cout <<
"\n=== Stored Projects ===\n";
544 for (
const auto& proj : projects) {
545 std::cout <<
" " << proj.project_name <<
"\n";
546 std::cout <<
" ROM Hash: " << proj.rom_hash.substr(0, 16) <<
"...\n";
547 std::cout <<
" Last Accessed: "
548 << absl::FormatTime(absl::FromUnixMillis(proj.last_accessed))
552 return absl::OkStatus();
555 if (command ==
"--recent-memories") {
557 if (args.size() >= 2) {
558 limit = std::stoi(args[1]);
561 if (memories.empty()) {
562 std::cout <<
"No memories stored.\n";
564 std::cout <<
"\n=== Recent Memories ===\n";
565 for (
const auto& mem : memories) {
566 std::cout <<
" Topic: " << mem.topic <<
"\n";
567 std::cout <<
" Summary: " << mem.summary <<
"\n";
568 std::cout <<
" Facts: " << mem.key_facts.size() <<
" key facts\n";
569 std::cout <<
" Created: "
570 << absl::FormatTime(absl::FromUnixMillis(mem.created_at))
575 return absl::OkStatus();
578 return absl::InvalidArgumentError(
579 "Unknown learn command. Use 'z3ed agent learn' for usage.");
584 auto proposals = registry.ListProposals();
586 if (proposals.empty()) {
587 std::cout <<
"No proposals found.\n";
589 <<
"Run 'z3ed agent run --prompt \"...\"' to create a proposal.\n";
590 return absl::OkStatus();
593 std::cout <<
"\n=== Agent Proposals ===\n\n";
595 for (
const auto& proposal : proposals) {
596 std::cout <<
"ID: " << proposal.id <<
"\n";
597 std::cout <<
" Status: ";
598 switch (proposal.status) {
600 std::cout <<
"Pending";
603 std::cout <<
"Accepted";
606 std::cout <<
"Rejected";
610 std::cout <<
" Created: " << absl::FormatTime(proposal.created_at) <<
"\n";
611 std::cout <<
" Prompt: " << proposal.prompt <<
"\n";
612 std::cout <<
" Commands: " << proposal.commands_executed <<
"\n";
613 std::cout <<
" Bytes Changed: " << proposal.bytes_changed <<
"\n";
617 std::cout <<
"Total: " << proposals.size() <<
" proposal(s)\n";
618 std::cout <<
"\nUse 'z3ed agent diff --proposal-id=<id>' to view details.\n";
620 return absl::OkStatus();
625 auto status = rom.
SaveToFile({.save_new =
false});
629 std::cout <<
"ā
Changes committed successfully." << std::endl;
631 return absl::AbortedError(
"No ROM loaded.");
633 return absl::OkStatus();
642 std::cout <<
"ā
Changes reverted successfully." << std::endl;
644 return absl::AbortedError(
"No ROM loaded.");
646 return absl::OkStatus();
653 std::optional<ResourceSchema> resource_schema;
654 if (options.resource.has_value()) {
655 auto resource_or = catalog.GetResource(*options.resource);
656 if (!resource_or.ok()) {
657 return resource_or.status();
659 resource_schema = resource_or.value();
663 if (options.format ==
"json") {
664 if (resource_schema.has_value()) {
665 payload = catalog.SerializeResource(*resource_schema);
667 payload = catalog.SerializeResources(catalog.AllResources());
670 std::string last_updated =
671 options.last_updated.has_value()
672 ? *options.last_updated
673 : absl::FormatTime(
"%Y-%m-%d", absl::Now(), absl::LocalTimeZone());
674 if (resource_schema.has_value()) {
675 std::vector<ResourceSchema> schemas{*resource_schema};
676 payload = catalog.SerializeResourcesAsYaml(schemas, options.version,
679 payload = catalog.SerializeResourcesAsYaml(catalog.AllResources(),
680 options.version, last_updated);
684 if (options.output_path.has_value()) {
685 std::ofstream out(*options.output_path, std::ios::binary | std::ios::trunc);
686 if (!out.is_open()) {
687 return absl::InternalError(absl::StrFormat(
688 "Failed to open %s for writing", *options.output_path));
693 return absl::InternalError(absl::StrFormat(
"Failed to write schema to %s",
694 *options.output_path));
696 std::cout << absl::StrFormat(
"Wrote %s schema to %s", options.format,
697 *options.output_path)
699 return absl::OkStatus();
702 std::cout << payload << std::endl;
703 return absl::OkStatus();
708 std::optional<std::string> proposal_id;
709 for (
size_t i = 0; i < arg_vec.size(); ++i) {
710 const std::string& token = arg_vec[i];
711 if (absl::StartsWith(token,
"--proposal-id=")) {
712 proposal_id = token.substr(14);
715 if (token ==
"--proposal-id" && i + 1 < arg_vec.size()) {
716 proposal_id = arg_vec[i + 1];
721 if (!proposal_id.has_value() || proposal_id->empty()) {
722 return absl::InvalidArgumentError(
723 "Usage: agent accept --proposal-id <proposal_id>");
730 std::cout <<
"Proposal '" << *proposal_id <<
"' is already accepted."
732 return absl::OkStatus();
735 if (metadata.sandbox_rom_path.empty()) {
736 return absl::FailedPreconditionError(
737 absl::StrCat(
"Proposal '", *proposal_id,
738 "' is missing sandbox ROM metadata. Cannot accept."));
741 if (!std::filesystem::exists(metadata.sandbox_rom_path)) {
742 return absl::NotFoundError(absl::StrCat(
743 "Sandbox ROM not found at ", metadata.sandbox_rom_path.string()));
747 EnsureRomLoaded(rom,
"agent accept --proposal-id <proposal_id>"));
750 auto sandbox_load_status =
751 sandbox_rom.
LoadFromFile(metadata.sandbox_rom_path.string());
752 if (!sandbox_load_status.ok()) {
753 return absl::InternalError(absl::StrCat(
"Failed to load sandbox ROM: ",
754 sandbox_load_status.message()));
757 if (rom.
size() != sandbox_rom.
size()) {
758 rom.
Expand(
static_cast<int>(sandbox_rom.
size()));
762 if (!copy_status.ok()) {
763 return absl::InternalError(absl::StrCat(
"Failed to copy sandbox ROM data: ",
764 copy_status.message()));
767 auto save_status = rom.
SaveToFile({.save_new =
false});
768 if (!save_status.ok()) {
769 return absl::InternalError(absl::StrCat(
770 "Failed to save changes to main ROM: ", save_status.message()));
777 absl::StrCat(
"Proposal accepted and applied to ", rom.
filename())));
779 if (!metadata.sandbox_id.empty()) {
782 if (!remove_status.ok()) {
783 std::cerr <<
"Warning: Failed to remove sandbox '" << metadata.sandbox_id
784 <<
"': " << remove_status.message() <<
"\n";
788 std::cout <<
"ā
Proposal '" << *proposal_id <<
"' accepted and applied to '"
789 << rom.
filename() <<
"'." << std::endl;
790 std::cout <<
" Source sandbox ROM: " << metadata.sandbox_rom_path
793 return absl::OkStatus();
The Rom class is used to load, save, and modify Rom data. This is a generic SNES ROM container and do...
project::ResourceLabelManager * resource_label()
absl::Status LoadFromFile(const std::string &filename, const LoadOptions &options=LoadOptions::Defaults())
const auto & vector() const
absl::Status WriteVector(int addr, std::vector< uint8_t > data)
absl::Status SaveToFile(const SaveSettings &settings)
static ProposalRegistry & Instance()
static const ResourceCatalog & Instance()
absl::Status RemoveSandbox(const std::string &id)
absl::StatusOr< SandboxMetadata > ActiveSandbox() const
static RomSandboxManager & Instance()
Generates and manages tile16 editing proposals.
absl::StatusOr< Tile16Proposal > GenerateFromCommands(const std::string &prompt, const std::vector< std::string > &commands, const std::string &ai_service, Rom *rom)
Generate a tile16 proposal from an AI-generated command list.
absl::Status SaveProposal(const Tile16Proposal &proposal, const std::string &path)
Save a proposal to a JSON file for later review.
Manages persistent learned information across agent sessions.
std::optional< std::string > GetPreference(const std::string &key) const
std::vector< ProjectContext > GetAllProjects() const
std::vector< ConversationMemory > GetRecentMemories(int limit=10) const
absl::Status ImportFromJSON(const std::string &json_data)
absl::Status Initialize()
absl::Status SetPreference(const std::string &key, const std::string &value)
absl::StatusOr< std::string > ExportToJSON() const
std::map< std::string, std::string > GetAllPreferences() const
ABSL_DECLARE_FLAG(std::string, rom)
#define ASSIGN_OR_RETURN(type_variable_name, expression)
absl::Status EnsureRomLoaded(Rom &rom, const std::string &command)
absl::StatusOr< DescribeOptions > ParseDescribeArgs(const std::vector< std::string > &args)
absl::Status TryLoadProjectAndLabels(Rom &rom)
absl::Status HandleLearnCommand(const std::vector< std::string > &args)
absl::Status HandleAcceptCommand(const std::vector< std::string > &args, Rom &rom)
absl::Status HandleRunCommand(const std::vector< std::string > &args, Rom &rom)
absl::Status HandleCommitCommand(Rom &rom)
absl::StatusOr< ProposalCreationResult > CreateProposalFromAgentResponse(const ProposalCreationRequest &)
absl::Status HandleDescribeCommand(const std::vector< std::string > &args)
absl::Status HandleDiffCommand(Rom &rom, const std::vector< std::string > &args)
absl::Status HandleRevertCommand(Rom &rom)
absl::Status HandleListCommand()
absl::Status HandlePlanCommand(const std::vector< std::string > &args)
std::unique_ptr< AIService > CreateAIService()
AIServiceConfig BuildAIServiceConfigFromFlags()
#define RETURN_IF_ERROR(expr)
std::string rom_path_hint
std::vector< std::string > commands
const AgentResponse * response
std::string sandbox_label
std::optional< std::string > resource
std::optional< std::string > output_path
std::optional< std::string > last_updated
std::unordered_map< std::string, std::unordered_map< std::string, std::string > > labels_
Modern project structure with comprehensive settings consolidation.
std::unordered_map< std::string, std::unordered_map< std::string, std::string > > resource_labels
std::string labels_filename
absl::Status InitializeEmbeddedLabels(const std::unordered_map< std::string, std::unordered_map< std::string, std::string > > &labels)
absl::Status Open(const std::string &project_path)
static std::unordered_map< std::string, std::unordered_map< std::string, std::string > > ToResourceLabels()
Convert all labels to a structured map for project embedding.