10#include "absl/flags/declare.h"
11#include "absl/flags/flag.h"
12#include "absl/status/status.h"
13#include "absl/status/status.h"
14#include "absl/strings/ascii.h"
15#include "absl/strings/match.h"
16#include "absl/strings/str_cat.h"
17#include "absl/strings/str_format.h"
18#include "absl/strings/str_join.h"
19#include "absl/time/clock.h"
20#include "absl/time/time.h"
21#include "absl/strings/string_view.h"
51 std::string format =
"json";
53 std::string version =
"0.1.0";
62 auto project_status = project.
Open(
".");
64 if (project_status.ok()) {
65 std::cout <<
"š Loaded project: " << project.
name <<
"\n";
69 if (labels_status.ok()) {
70 std::cout <<
"ā
Embedded labels initialized (all Zelda3 resources available)\n";
77 std::cout <<
"š·ļø Loaded custom labels from: " << project.
labels_filename <<
"\n";
84 label_mgr->labels_loaded_ =
true;
85 std::cout <<
"š·ļø Using embedded Zelda3 labels (rooms, sprites, entrances, items, etc.)\n";
90 std::cout <<
"ā¹ļø No project file found. Using embedded default Zelda3 labels.\n";
94 return absl::OkStatus();
99 return absl::OkStatus();
102 std::string rom_path = absl::GetFlag(FLAGS_rom);
103 if (rom_path.empty()) {
104 return absl::FailedPreconditionError(
106 "No ROM loaded. Pass --rom=<path> when running %s.\n"
107 "Example: z3ed %s --rom=zelda3.sfc",
114 return absl::FailedPreconditionError(absl::StrFormat(
115 "Failed to load ROM from '%s': %s", rom_path, status.message()));
118 return absl::OkStatus();
122 const std::vector<std::string>& args) {
124 for (
size_t i = 0; i < args.size(); ++i) {
125 const std::string& token = args[i];
126 std::string flag = token;
127 std::optional<std::string> inline_value;
129 if (absl::StartsWith(token,
"--")) {
130 auto eq_pos = token.find(
'=');
131 if (eq_pos != std::string::npos) {
132 flag = token.substr(0, eq_pos);
133 inline_value = token.substr(eq_pos + 1);
138 [&](absl::string_view flag_name) -> absl::StatusOr<std::string> {
139 if (inline_value.has_value()) {
140 return *inline_value;
142 if (i + 1 >= args.size()) {
143 return absl::InvalidArgumentError(
144 absl::StrFormat(
"Flag %s requires a value", flag_name));
149 if (flag ==
"--resource") {
151 options.
resource = std::move(value);
152 }
else if (flag ==
"--format") {
154 options.
format = std::move(value);
155 }
else if (flag ==
"--output") {
158 }
else if (flag ==
"--version") {
160 options.
version = std::move(value);
161 }
else if (flag ==
"--last-updated") {
165 return absl::InvalidArgumentError(
166 absl::StrFormat(
"Unknown flag for agent describe: %s", token));
171 if (options.
format !=
"json" && options.
format !=
"yaml") {
172 return absl::InvalidArgumentError(
"--format must be either json or yaml");
182 if (arg_vec.size() < 2 || arg_vec[0] !=
"--prompt") {
183 return absl::InvalidArgumentError(
"Usage: agent run --prompt <prompt>");
185 std::string prompt = arg_vec[1];
187 RETURN_IF_ERROR(EnsureRomLoaded(rom,
"agent run --prompt \"<prompt>\""));
191 auto response_or = ai_service->GenerateResponse(prompt);
192 if (!response_or.ok()) {
193 return response_or.status();
197 return absl::FailedPreconditionError(
198 "Agent response did not include any executable commands.");
201 std::string provider = absl::GetFlag(FLAGS_ai_provider);
213 const auto& metadata = proposal_result.metadata;
214 std::filesystem::path proposal_dir = metadata.log_path.parent_path();
217 <<
"ā
Agent successfully planned and executed changes in a sandbox."
219 std::cout <<
" Proposal ID: " << metadata.id << std::endl;
220 std::cout <<
" Sandbox ROM: " << metadata.sandbox_rom_path << std::endl;
221 std::cout <<
" Proposal dir: " << proposal_dir << std::endl;
222 std::cout <<
" Diff file: " << metadata.diff_path << std::endl;
223 std::cout <<
" Log file: " << metadata.log_path << std::endl;
224 std::cout <<
" Proposal JSON: " << proposal_result.proposal_json_path
226 std::cout <<
" Commands executed: "
227 << proposal_result.executed_commands << std::endl;
228 std::cout <<
" Tile16 changes: " << proposal_result.change_count
230 std::cout <<
"\nTo review the changes, run:\n";
231 std::cout <<
" z3ed agent diff --proposal-id " << metadata.id << std::endl;
232 std::cout <<
"\nTo accept the changes, run:\n";
233 std::cout <<
" z3ed agent accept --proposal-id " << metadata.id << std::endl;
235 return absl::OkStatus();
239 if (arg_vec.size() < 2 || arg_vec[0] !=
"--prompt") {
240 return absl::InvalidArgumentError(
"Usage: agent plan --prompt <prompt>");
242 std::string prompt = arg_vec[1];
245 auto response_or = ai_service->GenerateResponse(prompt);
246 if (!response_or.ok()) {
247 return response_or.status();
249 std::vector<std::string> commands = response_or.value().commands;
255 if (!proposal_or.ok()) {
256 return proposal_or.status();
258 auto proposal = proposal_or.value();
261 auto plans_dir = registry.RootDirectory() /
"plans";
263 std::filesystem::create_directories(plans_dir, ec);
265 return absl::InternalError(absl::StrCat(
"Failed to create plans directory: ", ec.message()));
268 auto plan_path = plans_dir / (proposal.id +
".json");
269 auto save_status = generator.
SaveProposal(proposal, plan_path.string());
270 if (!save_status.ok()) {
274 std::cout <<
"AI Agent Plan (Proposal ID: " << proposal.id <<
"):\n";
275 std::cout << proposal.ToJson() << std::endl;
276 std::cout <<
"\nā
Plan saved to: " << plan_path.string() << std::endl;
278 return absl::OkStatus();
282 std::optional<std::string> proposal_id;
283 for (
size_t i = 0; i < args.size(); ++i) {
284 const std::string& token = args[i];
285 if (absl::StartsWith(token,
"--proposal-id=")) {
286 proposal_id = token.substr(14);
287 }
else if (token ==
"--proposal-id" && i + 1 < args.size()) {
288 proposal_id = args[i + 1];
294 absl::StatusOr<ProposalRegistry::ProposalMetadata> proposal_or;
295 if (proposal_id.has_value()) {
296 proposal_or = registry.GetProposal(proposal_id.value());
298 proposal_or = registry.GetLatestPendingProposal();
301 if (proposal_or.ok()) {
302 const auto& proposal = proposal_or.value();
304 std::cout <<
"\n=== Proposal Diff ===\n";
305 std::cout <<
"Proposal ID: " << proposal.id <<
"\n";
306 std::cout <<
"Sandbox ID: " << proposal.sandbox_id <<
"\n";
307 std::cout <<
"Prompt: " << proposal.prompt <<
"\n";
308 std::cout <<
"Description: " << proposal.description <<
"\n";
309 std::cout <<
"Status: ";
310 switch (proposal.status) {
312 std::cout <<
"Pending";
315 std::cout <<
"Accepted";
318 std::cout <<
"Rejected";
322 std::cout <<
"Created: " << absl::FormatTime(proposal.created_at) <<
"\n";
323 std::cout <<
"Commands Executed: " << proposal.commands_executed <<
"\n";
324 std::cout <<
"Bytes Changed: " << proposal.bytes_changed <<
"\n\n";
326 if (!proposal.sandbox_rom_path.empty()) {
327 std::cout <<
"Sandbox ROM: " << proposal.sandbox_rom_path <<
"\n";
329 std::cout <<
"Proposal directory: "
330 << proposal.log_path.parent_path() <<
"\n";
331 std::cout <<
"Diff file: " << proposal.diff_path <<
"\n";
332 std::cout <<
"Log file: " << proposal.log_path <<
"\n\n";
334 if (std::filesystem::exists(proposal.diff_path)) {
335 std::cout <<
"--- Diff Content ---\n";
336 std::ifstream diff_file(proposal.diff_path);
337 if (diff_file.is_open()) {
339 while (std::getline(diff_file, line)) {
340 std::cout << line <<
"\n";
343 std::cout <<
"(Unable to read diff file)\n";
346 std::cout <<
"(No diff file found)\n";
349 std::cout <<
"\n--- Execution Log ---\n";
350 if (std::filesystem::exists(proposal.log_path)) {
351 std::ifstream log_file(proposal.log_path);
352 if (log_file.is_open()) {
355 while (std::getline(log_file, line)) {
356 std::cout << line <<
"\n";
358 if (line_count > 50) {
359 std::cout <<
"... (log truncated, see " << proposal.log_path
360 <<
" for full output)\n";
365 std::cout <<
"(Unable to read log file)\n";
368 std::cout <<
"(No log file found)\n";
371 std::cout <<
"\n=== Next Steps ===\n";
372 std::cout <<
"To accept changes: z3ed agent commit\n";
373 std::cout <<
"To reject changes: z3ed agent revert\n";
374 std::cout <<
"To review in GUI: yaze --proposal=" << proposal.id <<
"\n";
376 return absl::OkStatus();
381 if (!sandbox_or.ok()) {
382 return absl::NotFoundError(
383 "No pending proposals found and no active sandbox. Run 'z3ed agent "
388 auto status = absl::UnimplementedError(
"RomDiff not yet implemented in new CommandHandler system");
393 return absl::AbortedError(
"No ROM loaded.");
395 return absl::OkStatus();
400 static bool initialized =
false;
405 std::cerr <<
"Failed to initialize learned knowledge service: "
406 << status.message() << std::endl;
414 std::cout <<
"\nUsage: z3ed agent learn [options]\n\n";
415 std::cout <<
"Options:\n";
416 std::cout <<
" --preference <key>=<value> Set a preference\n";
417 std::cout <<
" --get-preference <key> Get a preference value\n";
418 std::cout <<
" --list-preferences List all preferences\n";
419 std::cout <<
" --pattern <type> --data <json> Learn a ROM pattern\n";
420 std::cout <<
" --query-patterns <type> Query learned patterns\n";
421 std::cout <<
" --project <name> --context <text> Save project context\n";
422 std::cout <<
" --get-project <name> Get project context\n";
423 std::cout <<
" --list-projects List all projects\n";
424 std::cout <<
" --memory <topic> --summary <text> Store conversation memory\n";
425 std::cout <<
" --search-memories <query> Search memories\n";
426 std::cout <<
" --recent-memories [limit] Show recent memories\n";
427 std::cout <<
" --export <file> Export all data to JSON\n";
428 std::cout <<
" --import <file> Import data from JSON\n";
429 std::cout <<
" --stats Show statistics\n";
430 std::cout <<
" --clear Clear all learned data\n";
431 return absl::OkStatus();
435 std::string command = args[0];
437 if (command ==
"--preference" && args.size() >= 2) {
438 std::string pref = args[1];
439 size_t eq_pos = pref.find(
'=');
440 if (eq_pos == std::string::npos) {
441 return absl::InvalidArgumentError(
"Preference must be in format key=value");
443 std::string key = pref.substr(0, eq_pos);
444 std::string value = pref.substr(eq_pos + 1);
447 std::cout <<
"ā Preference '" << key <<
"' set to '" << value <<
"'\n";
452 if (command ==
"--get-preference" && args.size() >= 2) {
455 std::cout << args[1] <<
" = " << *value <<
"\n";
457 std::cout <<
"Preference '" << args[1] <<
"' not found\n";
459 return absl::OkStatus();
462 if (command ==
"--list-preferences") {
465 std::cout <<
"No preferences stored.\n";
467 std::cout <<
"\n=== Stored Preferences ===\n";
468 for (
const auto& [key, value] : prefs) {
469 std::cout <<
" " << key <<
" = " << value <<
"\n";
472 return absl::OkStatus();
475 if (command ==
"--stats") {
476 auto stats = learn_service.
GetStats();
477 std::cout <<
"\n=== Learned Knowledge Statistics ===\n";
479 std::cout <<
" ROM Patterns: " << stats.pattern_count <<
"\n";
480 std::cout <<
" Projects: " << stats.project_count <<
"\n";
481 std::cout <<
" Memories: " << stats.memory_count <<
"\n";
482 std::cout <<
" First learned: " << absl::FormatTime(absl::FromUnixMillis(stats.first_learned_at)) <<
"\n";
483 std::cout <<
" Last updated: " << absl::FormatTime(absl::FromUnixMillis(stats.last_updated_at)) <<
"\n";
484 return absl::OkStatus();
487 if (command ==
"--export" && args.size() >= 2) {
490 return json.status();
492 std::ofstream file(args[1]);
493 if (!file.is_open()) {
494 return absl::InternalError(
"Failed to open file for writing");
497 std::cout <<
"ā Exported learned data to " << args[1] <<
"\n";
498 return absl::OkStatus();
501 if (command ==
"--import" && args.size() >= 2) {
502 std::ifstream file(args[1]);
503 if (!file.is_open()) {
504 return absl::NotFoundError(
"File not found: " + args[1]);
506 std::stringstream buffer;
507 buffer << file.rdbuf();
510 std::cout <<
"ā Imported learned data from " << args[1] <<
"\n";
515 if (command ==
"--clear") {
516 auto status = learn_service.
ClearAll();
518 std::cout <<
"ā All learned data cleared\n";
523 if (command ==
"--list-projects") {
525 if (projects.empty()) {
526 std::cout <<
"No projects stored.\n";
528 std::cout <<
"\n=== Stored Projects ===\n";
529 for (
const auto& proj : projects) {
530 std::cout <<
" " << proj.project_name <<
"\n";
531 std::cout <<
" ROM Hash: " << proj.rom_hash.substr(0, 16) <<
"...\n";
532 std::cout <<
" Last Accessed: " << absl::FormatTime(absl::FromUnixMillis(proj.last_accessed)) <<
"\n";
535 return absl::OkStatus();
538 if (command ==
"--recent-memories") {
540 if (args.size() >= 2) {
541 limit = std::stoi(args[1]);
544 if (memories.empty()) {
545 std::cout <<
"No memories stored.\n";
547 std::cout <<
"\n=== Recent Memories ===\n";
548 for (
const auto& mem : memories) {
549 std::cout <<
" Topic: " << mem.topic <<
"\n";
550 std::cout <<
" Summary: " << mem.summary <<
"\n";
551 std::cout <<
" Facts: " << mem.key_facts.size() <<
" key facts\n";
552 std::cout <<
" Created: " << absl::FormatTime(absl::FromUnixMillis(mem.created_at)) <<
"\n";
556 return absl::OkStatus();
559 return absl::InvalidArgumentError(
"Unknown learn command. Use 'z3ed agent learn' for usage.");
564 auto proposals = registry.ListProposals();
566 if (proposals.empty()) {
567 std::cout <<
"No proposals found.\n";
569 <<
"Run 'z3ed agent run --prompt \"...\"' to create a proposal.\n";
570 return absl::OkStatus();
573 std::cout <<
"\n=== Agent Proposals ===\n\n";
575 for (
const auto& proposal : proposals) {
576 std::cout <<
"ID: " << proposal.id <<
"\n";
577 std::cout <<
" Status: ";
578 switch (proposal.status) {
580 std::cout <<
"Pending";
583 std::cout <<
"Accepted";
586 std::cout <<
"Rejected";
590 std::cout <<
" Created: " << absl::FormatTime(proposal.created_at) <<
"\n";
591 std::cout <<
" Prompt: " << proposal.prompt <<
"\n";
592 std::cout <<
" Commands: " << proposal.commands_executed <<
"\n";
593 std::cout <<
" Bytes Changed: " << proposal.bytes_changed <<
"\n";
597 std::cout <<
"Total: " << proposals.size() <<
" proposal(s)\n";
598 std::cout <<
"\nUse 'z3ed agent diff --proposal-id=<id>' to view details.\n";
600 return absl::OkStatus();
605 auto status = rom.
SaveToFile({.save_new =
false});
609 std::cout <<
"ā
Changes committed successfully." << std::endl;
611 return absl::AbortedError(
"No ROM loaded.");
613 return absl::OkStatus();
622 std::cout <<
"ā
Changes reverted successfully." << std::endl;
624 return absl::AbortedError(
"No ROM loaded.");
626 return absl::OkStatus();
633 std::optional<ResourceSchema> resource_schema;
634 if (options.resource.has_value()) {
635 auto resource_or = catalog.GetResource(*options.resource);
636 if (!resource_or.ok()) {
637 return resource_or.status();
639 resource_schema = resource_or.value();
643 if (options.format ==
"json") {
644 if (resource_schema.has_value()) {
645 payload = catalog.SerializeResource(*resource_schema);
647 payload = catalog.SerializeResources(catalog.AllResources());
650 std::string last_updated =
651 options.last_updated.has_value()
652 ? *options.last_updated
653 : absl::FormatTime(
"%Y-%m-%d", absl::Now(), absl::LocalTimeZone());
654 if (resource_schema.has_value()) {
655 std::vector<ResourceSchema> schemas{*resource_schema};
656 payload = catalog.SerializeResourcesAsYaml(schemas, options.version,
659 payload = catalog.SerializeResourcesAsYaml(catalog.AllResources(),
660 options.version, last_updated);
664 if (options.output_path.has_value()) {
665 std::ofstream out(*options.output_path, std::ios::binary | std::ios::trunc);
666 if (!out.is_open()) {
667 return absl::InternalError(absl::StrFormat(
668 "Failed to open %s for writing", *options.output_path));
673 return absl::InternalError(absl::StrFormat(
"Failed to write schema to %s",
674 *options.output_path));
676 std::cout << absl::StrFormat(
"Wrote %s schema to %s", options.format,
677 *options.output_path)
679 return absl::OkStatus();
682 std::cout << payload << std::endl;
683 return absl::OkStatus();
688 std::optional<std::string> proposal_id;
689 for (
size_t i = 0; i < arg_vec.size(); ++i) {
690 const std::string& token = arg_vec[i];
691 if (absl::StartsWith(token,
"--proposal-id=")) {
692 proposal_id = token.substr(14);
695 if (token ==
"--proposal-id" && i + 1 < arg_vec.size()) {
696 proposal_id = arg_vec[i + 1];
701 if (!proposal_id.has_value() || proposal_id->empty()) {
702 return absl::InvalidArgumentError(
703 "Usage: agent accept --proposal-id <proposal_id>");
710 std::cout <<
"Proposal '" << *proposal_id <<
"' is already accepted."
712 return absl::OkStatus();
715 if (metadata.sandbox_rom_path.empty()) {
716 return absl::FailedPreconditionError(absl::StrCat(
717 "Proposal '", *proposal_id,
718 "' is missing sandbox ROM metadata. Cannot accept."));
721 if (!std::filesystem::exists(metadata.sandbox_rom_path)) {
722 return absl::NotFoundError(absl::StrCat(
723 "Sandbox ROM not found at ", metadata.sandbox_rom_path.string()));
727 EnsureRomLoaded(rom,
"agent accept --proposal-id <proposal_id>"));
732 if (!sandbox_load_status.ok()) {
733 return absl::InternalError(absl::StrCat(
734 "Failed to load sandbox ROM: ", sandbox_load_status.message()));
737 if (rom.
size() != sandbox_rom.
size()) {
738 rom.
Expand(
static_cast<int>(sandbox_rom.
size()));
742 if (!copy_status.ok()) {
743 return absl::InternalError(absl::StrCat(
744 "Failed to copy sandbox ROM data: ", copy_status.message()));
747 auto save_status = rom.
SaveToFile({.save_new =
false});
748 if (!save_status.ok()) {
749 return absl::InternalError(absl::StrCat(
750 "Failed to save changes to main ROM: ", save_status.message()));
757 absl::StrCat(
"Proposal accepted and applied to ", rom.
filename())));
759 if (!metadata.sandbox_id.empty()) {
762 if (!remove_status.ok()) {
763 std::cerr <<
"Warning: Failed to remove sandbox '" << metadata.sandbox_id
764 <<
"': " << remove_status.message() <<
"\n";
768 std::cout <<
"ā
Proposal '" << *proposal_id <<
"' accepted and applied to '"
769 << rom.
filename() <<
"'." << std::endl;
770 std::cout <<
" Source sandbox ROM: " << metadata.sandbox_rom_path
773 return absl::OkStatus();
The Rom class is used to load, save, and modify Rom data.
project::ResourceLabelManager * resource_label()
absl::Status LoadFromFile(const std::string &filename, bool z3_load=true)
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 RETURN_IF_ERROR(expression)
#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::StatusOr< ProposalCreationResult > CreateProposalFromAgentResponse(const ProposalCreationRequest &request)
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::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()
Main namespace for the application.
static RomLoadOptions CliDefaults()
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.
absl::Status InitializeEmbeddedLabels()
std::unordered_map< std::string, std::unordered_map< std::string, std::string > > resource_labels
std::string labels_filename
absl::Status Open(const std::string &project_path)