scawful/yaze
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

backend-infra-engineer: Release v0.3.2 snapshot

Browse Source
This commit is contained in:
scawful
2025-10-17 12:10:25 -04:00
parent 4371618a9b
commit 3d71417f62
857 changed files with 174954 additions and 45626 deletions
Download Patch File Download Diff File Expand all files Collapse all files

552
assets/agent/function_schemas.json Normal file
View File

@@ -0,0 +1,552 @@
{
"function_declarations": [
{
"name": "resource-list",
"description": "List all resources of a specific type from the ROM (rooms, sprites, dungeons, entrances, items, overlords)",
"parameters": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": ["room", "sprite", "dungeon", "entrance", "item", "overlord"],
"description": "Type of resource to list"
}
},
"required": ["type"]
}
},
{
"name": "resource-search",
"description": "Search for resources by name or pattern",
"parameters": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": ["room", "sprite", "dungeon", "entrance", "item"],
"description": "Type of resource to search"
},
"query": {
"type": "string",
"description": "Search query or pattern to match"
}
},
"required": ["type", "query"]
}
},
{
"name": "emulator-press-buttons",
"description": "Presses and immediately releases one or more buttons on the SNES controller.",
"parameters": {
"type": "object",
"properties": {
"buttons": {
"type": "string",
"description": "A comma-separated list of buttons to press (e.g., 'A,Right,Start')."
}
},
"required": ["buttons"]
}
},
{
"name": "emulator-hold-buttons",
"description": "Holds down one or more buttons for a specified duration.",
"parameters": {
"type": "object",
"properties": {
"buttons": {
"type": "string",
"description": "A comma-separated list of buttons to hold."
},
"duration": {
"type": "integer",
"description": "The duration in milliseconds to hold the buttons."
}
},
"required": ["buttons", "duration"]
}
},
{
"name": "emulator-get-state",
"description": "Retrieves the current state of the game from the emulator.",
"parameters": {
"type": "object",
"properties": {
"screenshot": {
"type": "boolean",
"description": "Whether to include a screenshot of the current frame."
}
}
}
},
{
"name": "emulator-read-memory",
"description": "Reads a block of memory from the SNES WRAM.",
"parameters": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "The memory address to read from (e.g., '0x7E0010')."
},
"length": {
"type": "integer",
"description": "The number of bytes to read."
}
},
"required": ["address"]
}
},
{
"name": "emulator-write-memory",
"description": "Writes a block of data to the SNES WRAM.",
"parameters": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "The memory address to write to."
},
"data": {
"type": "string",
"description": "The data to write, as a hex string (e.g., 'AABBCCDD')."
}
},
"required": ["address", "data"]
}
},
{
"name": "emulator-set-breakpoint",
"description": "Set a breakpoint in the emulator to pause execution at a specific address or when specific memory is accessed. Essential for debugging game logic, input handling, and timing issues.",
"parameters": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Memory address in hex format (e.g., '0x0083D7' for ALTTP's NMI_ReadJoypads routine)"
},
"type": {
"type": "string",
"enum": ["execute", "read", "write", "access"],
"description": "Breakpoint type: 'execute' breaks when PC reaches address, 'read'/'write'/'access' break on memory access"
},
"description": {
"type": "string",
"description": "Human-readable label for this breakpoint (e.g., 'NMI handler entry')"
}
},
"required": ["address"]
}
},
{
"name": "emulator-clear-breakpoint",
"description": "Remove a breakpoint by ID",
"parameters": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Breakpoint ID to remove (from list-breakpoints output)"
}
},
"required": ["id"]
}
},
{
"name": "emulator-list-breakpoints",
"description": "List all active breakpoints with their addresses, types, hit counts, and states",
"parameters": {
"type": "object",
"properties": {}
}
},
{
"name": "emulator-step",
"description": "Step the emulator forward by one or more CPU instructions and return the new CPU state",
"parameters": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "Number of instructions to execute (default: 1)"
}
}
}
},
{
"name": "emulator-run",
"description": "Run the emulator until a breakpoint is hit or for a specified number of frames",
"parameters": {
"type": "object",
"properties": {
"until_break": {
"type": "boolean",
"description": "Run until breakpoint is hit (default: false)"
},
"frames": {
"type": "integer",
"description": "Number of frames to run (if not until_break)"
}
}
}
},
{
"name": "emulator-pause",
"description": "Pause emulator execution for inspection",
"parameters": {
"type": "object",
"properties": {}
}
},
{
"name": "emulator-reset",
"description": "Reset the emulator to initial state (hard reset)",
"parameters": {
"type": "object",
"properties": {}
}
},
{
"name": "emulator-get-registers",
"description": "Get current CPU register values (A, X, Y, PC, PB, DB, SP, flags) for debugging",
"parameters": {
"type": "object",
"properties": {}
}
},
{
"name": "emulator-get-metrics",
"description": "Get emulator performance metrics including FPS, cycle count, audio queue status",
"parameters": {
"type": "object",
"properties": {}
}
},
{
"name": "dungeon-list-sprites",
"description": "List all sprites in a specific dungeon or room",
"parameters": {
"type": "object",
"properties": {
"dungeon": {
"type": "string",
"description": "Dungeon name (e.g., 'hyrule_castle', 'eastern_palace') or leave empty for all"
},
"room_id": {
"type": "string",
"description": "Specific room ID to query (optional)"
}
}
}
},
{
"name": "dungeon-describe-room",
"description": "Get detailed information about a specific dungeon room including sprites, chests, layout, and connections",
"parameters": {
"type": "object",
"properties": {
"room_id": {
"type": "string",
"description": "Room ID to describe (0-296)"
},
"include_sprites": {
"type": "string",
"enum": ["true", "false"],
"description": "Include sprite information (default: true)"
}
},
"required": ["room_id"]
}
},
{
"name": "overworld-find-tile",
"description": "Find all locations where a specific tile16 ID appears in the overworld",
"parameters": {
"type": "object",
"properties": {
"tile_id": {
"type": "string",
"description": "Tile16 ID to search for (hex format like '0x42' or decimal)"
},
"map_id": {
"type": "string",
"description": "Specific overworld map to search (0-63, optional)"
}
},
"required": ["tile_id"]
}
},
{
"name": "overworld-describe-map",
"description": "Get detailed information about a specific overworld map including tile composition, warps, and sprites",
"parameters": {
"type": "object",
"properties": {
"map_id": {
"type": "string",
"description": "Overworld map ID (0-63 for light/dark world)"
},
"include_tiles": {
"type": "string",
"enum": ["true", "false"],
"description": "Include tile distribution statistics"
}
},
"required": ["map_id"]
}
},
{
"name": "overworld-list-warps",
"description": "List all warp/entrance points for a specific overworld map",
"parameters": {
"type": "object",
"properties": {
"map_id": {
"type": "string",
"description": "Overworld map ID (0-63)"
}
},
"required": ["map_id"]
}
},
{
"name": "overworld-list-sprites",
"description": "List all sprites placed on a specific overworld map",
"parameters": {
"type": "object",
"properties": {
"map_id": {
"type": "string",
"description": "Overworld map ID (0-63)"
}
},
"required": ["map_id"]
}
},
{
"name": "overworld-get-entrance",
"description": "Get detailed information about a specific entrance/exit including destination and properties",
"parameters": {
"type": "object",
"properties": {
"entrance_id": {
"type": "string",
"description": "Entrance ID to query"
}
},
"required": ["entrance_id"]
}
},
{
"name": "overworld-tile-stats",
"description": "Get statistical analysis of tile usage across overworld maps",
"parameters": {
"type": "object",
"properties": {
"map_id": {
"type": "string",
"description": "Specific map ID or 'all' for global statistics"
}
}
}
},
{
"name": "hex-read",
"description": "Read bytes from ROM at a specific address in hexadecimal",
"parameters": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "ROM address in hex format (e.g., '0x1C800')"
},
"length": {
"type": "integer",
"description": "Number of bytes to read (default: 16)"
},
"format": {
"type": "string",
"enum": ["hex", "ascii", "both"],
"description": "Output format (default: both)"
}
},
"required": ["address"]
}
},
{
"name": "hex-write",
"description": "Write bytes to ROM at a specific address (creates a proposal)",
"parameters": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "ROM address in hex format (e.g., '0x1C800')"
},
"data": {
"type": "string",
"description": "Hex data to write (space-separated bytes like 'FF 00 12 34')"
}
},
"required": ["address", "data"]
}
},
{
"name": "hex-search",
"description": "Search for a byte pattern in ROM",
"parameters": {
"type": "object",
"properties": {
"pattern": {
"type": "string",
"description": "Hex pattern to search (e.g., 'FF 00 ?? 12' where ?? is wildcard)"
},
"start_address": {
"type": "string",
"description": "Start address (default: 0x00000)"
},
"end_address": {
"type": "string",
"description": "End address (default: ROM size)"
}
},
"required": ["pattern"]
}
},
{
"name": "palette-get-colors",
"description": "Get all colors from a specific palette",
"parameters": {
"type": "object",
"properties": {
"group": {
"type": "integer",
"description": "Palette group index (0-based)"
},
"palette": {
"type": "integer",
"description": "Palette index within group (0-7)"
},
"format": {
"type": "string",
"enum": ["snes", "rgb", "hex"],
"description": "Color format (default: hex)"
}
},
"required": ["group", "palette"]
}
},
{
"name": "palette-set-color",
"description": "Set a specific color in a palette (creates a proposal)",
"parameters": {
"type": "object",
"properties": {
"group": {
"type": "integer",
"description": "Palette group index"
},
"palette": {
"type": "integer",
"description": "Palette index within group"
},
"color_index": {
"type": "integer",
"description": "Color index in palette (0-15)"
},
"color": {
"type": "string",
"description": "Color value in hex format (e.g., '#FF0000' or 'FF0000')"
}
},
"required": ["group", "palette", "color_index", "color"]
}
},
{
"name": "palette-analyze",
"description": "Analyze color usage and statistics for a palette or bitmap",
"parameters": {
"type": "object",
"properties": {
"target_type": {
"type": "string",
"enum": ["palette", "bitmap", "graphics_sheet"],
"description": "What to analyze"
},
"target_id": {
"type": "string",
"description": "ID or index of target"
}
},
"required": ["target_type", "target_id"]
}
},
{
"name": "todo-create",
"description": "Create a new TODO task for complex operations",
"parameters": {
"type": "object",
"properties": {
"description": {
"type": "string",
"description": "Task description"
},
"category": {
"type": "string",
"description": "Task category (e.g., 'rom_edit', 'ai_task', 'build')"
},
"priority": {
"type": "integer",
"description": "Priority level (0-10, higher = more important)"
}
},
"required": ["description"]
}
},
{
"name": "todo-list",
"description": "List all TODO tasks or filter by status/category",
"parameters": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": ["pending", "in_progress", "completed", "blocked", "cancelled"],
"description": "Filter by status"
},
"category": {
"type": "string",
"description": "Filter by category"
}
}
}
},
{
"name": "todo-update-status",
"description": "Update the status of a TODO task",
"parameters": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "TODO ID"
},
"status": {
"type": "string",
"enum": ["pending", "in_progress", "completed", "blocked", "cancelled"],
"description": "New status"
}
},
"required": ["id", "status"]
}
},
{
"name": "todo-next",
"description": "Get the next actionable TODO task (respecting dependencies and priority)",
"parameters": {
"type": "object",
"properties": {}
}
}
]
}