@retrotech71/appleii-agent 1.0.0

package/src/tools/load-smartport-image.js

@@ -0,0 +1,98 @@
+/*
+ * load-smartport-image.js - Load SmartPort hard drive image from filesystem
+ *
+ * Written by
+ *  Shawn Bullock <shawn@agenticexpert.ai>
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { homedir } from 'os';
+
+export const tool = {
+  name: "load_smartport_image",
+  description: "Load a SmartPort hard drive image file from the local filesystem and return as base64",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: {
+        type: "string",
+        description: "Path to SmartPort image file (supports ~ for home directory)",
+      },
+    },
+    required: ["path"],
+  },
+};
+
+export function handler(args) {
+  const { path: filePath } = args;
+
+  if (!filePath) {
+    return {
+      success: false,
+      error: "path parameter is required",
+    };
+  }
+
+  try {
+    // Expand ~ to home directory
+    let expandedPath = filePath;
+    if (filePath.startsWith('~/')) {
+      expandedPath = path.join(homedir(), filePath.slice(2));
+    } else if (filePath === '~') {
+      expandedPath = homedir();
+    }
+
+    // Resolve to absolute path
+    const absolutePath = path.resolve(expandedPath);
+
+    // Check if file exists
+    if (!fs.existsSync(absolutePath)) {
+      return {
+        success: false,
+        error: `File not found: ${absolutePath}`,
+      };
+    }
+
+    // Check if it's a file (not a directory)
+    const stats = fs.statSync(absolutePath);
+    if (!stats.isFile()) {
+      return {
+        success: false,
+        error: `Path is not a file: ${absolutePath}`,
+      };
+    }
+
+    // Validate SmartPort format
+    const supportedFormats = ['.hdv', '.po', '.2mg'];
+    const ext = path.extname(absolutePath).toLowerCase();
+    if (!supportedFormats.includes(ext)) {
+      return {
+        success: false,
+        error: `Unsupported SmartPort format: ${ext}. Supported formats: ${supportedFormats.join(', ')}`,
+      };
+    }
+
+    // Read file
+    const buffer = fs.readFileSync(absolutePath);
+
+    // Convert to base64
+    const base64Data = buffer.toString('base64');
+
+    // Get filename
+    const filename = path.basename(absolutePath);
+
+    return {
+      success: true,
+      data: base64Data,
+      filename: filename,
+      size: buffer.length,
+      path: absolutePath,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: `Failed to load SmartPort image: ${error.message}`,
+    };
+  }
+}

package/src/tools/save-asm-file.js

@@ -0,0 +1,107 @@
+/*
+ * save-asm-file.js - Save assembly source to filesystem
+ *
+ * Written by
+ *  Shawn Bullock <shawn@agenticexpert.ai>
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { homedir } from 'os';
+
+export const tool = {
+  name: "save_asm_file",
+  description: "Save assembly source code to a file on the local filesystem",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: {
+        type: "string",
+        description: "Path to save file (supports ~ for home directory, .s or .asm extension recommended)",
+      },
+      content: {
+        type: "string",
+        description: "Assembly source code to save",
+      },
+      overwrite: {
+        type: "boolean",
+        description: "Allow overwriting existing file (default: false)",
+        default: false,
+      },
+    },
+    required: ["path", "content"],
+  },
+};
+
+export function handler(args) {
+  const { path: filePath, content, overwrite = false } = args;
+
+  if (!filePath) {
+    return {
+      success: false,
+      error: "path parameter is required",
+    };
+  }
+
+  if (content === undefined || content === null) {
+    return {
+      success: false,
+      error: "content parameter is required",
+    };
+  }
+
+  try {
+    // Expand ~ to home directory
+    let expandedPath = filePath;
+    if (filePath.startsWith('~/')) {
+      expandedPath = path.join(homedir(), filePath.slice(2));
+    } else if (filePath === '~') {
+      return {
+        success: false,
+        error: "Cannot save to home directory root, please specify a filename",
+      };
+    }
+
+    // Resolve to absolute path
+    const absolutePath = path.resolve(expandedPath);
+
+    // Ensure parent directory exists
+    const dir = path.dirname(absolutePath);
+    if (!fs.existsSync(dir)) {
+      return {
+        success: false,
+        error: `Directory does not exist: ${dir}`,
+      };
+    }
+
+    // Check if file already exists
+    if (fs.existsSync(absolutePath) && !overwrite) {
+      return {
+        success: false,
+        error: `File already exists: ${absolutePath}. Use overwrite: true to replace it.`,
+        exists: true,
+      };
+    }
+
+    // Write file
+    fs.writeFileSync(absolutePath, content, 'utf8');
+
+    // Get file stats
+    const stats = fs.statSync(absolutePath);
+    const filename = path.basename(absolutePath);
+
+    return {
+      success: true,
+      filename: filename,
+      path: absolutePath,
+      size: stats.size,
+      lines: content.split('\n').length,
+      message: `Assembly source saved to ${filename}`,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: `Failed to save file: ${error.message}`,
+    };
+  }
+}

package/src/tools/save-basic-file.js

@@ -0,0 +1,107 @@
+/*
+ * save-basic-file.js - Save BASIC program to filesystem
+ *
+ * Written by
+ *  Shawn Bullock <shawn@agenticexpert.ai>
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { homedir } from 'os';
+
+export const tool = {
+  name: "save_basic_file",
+  description: "Save BASIC program text to a file on the local filesystem",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: {
+        type: "string",
+        description: "Path to save file (supports ~ for home directory, .bas extension recommended)",
+      },
+      content: {
+        type: "string",
+        description: "BASIC program text to save",
+      },
+      overwrite: {
+        type: "boolean",
+        description: "Allow overwriting existing file (default: false)",
+        default: false,
+      },
+    },
+    required: ["path", "content"],
+  },
+};
+
+export function handler(args) {
+  const { path: filePath, content, overwrite = false } = args;
+
+  if (!filePath) {
+    return {
+      success: false,
+      error: "path parameter is required",
+    };
+  }
+
+  if (content === undefined || content === null) {
+    return {
+      success: false,
+      error: "content parameter is required",
+    };
+  }
+
+  try {
+    // Expand ~ to home directory
+    let expandedPath = filePath;
+    if (filePath.startsWith('~/')) {
+      expandedPath = path.join(homedir(), filePath.slice(2));
+    } else if (filePath === '~') {
+      return {
+        success: false,
+        error: "Cannot save to home directory root, please specify a filename",
+      };
+    }
+
+    // Resolve to absolute path
+    const absolutePath = path.resolve(expandedPath);
+
+    // Ensure parent directory exists
+    const dir = path.dirname(absolutePath);
+    if (!fs.existsSync(dir)) {
+      return {
+        success: false,
+        error: `Directory does not exist: ${dir}`,
+      };
+    }
+
+    // Check if file already exists
+    if (fs.existsSync(absolutePath) && !overwrite) {
+      return {
+        success: false,
+        error: `File already exists: ${absolutePath}. Use overwrite: true to replace it.`,
+        exists: true,
+      };
+    }
+
+    // Write file
+    fs.writeFileSync(absolutePath, content, 'utf8');
+
+    // Get file stats
+    const stats = fs.statSync(absolutePath);
+    const filename = path.basename(absolutePath);
+
+    return {
+      success: true,
+      filename: filename,
+      path: absolutePath,
+      size: stats.size,
+      lines: content.split('\n').length,
+      message: `BASIC program saved to ${filename}`,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: `Failed to save file: ${error.message}`,
+    };
+  }
+}

package/src/tools/save-disk-file.js

@@ -0,0 +1,85 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+export const tool = {
+  name: "save_disk_file",
+  description: "Save disk file content to the local filesystem. Content should be base64 encoded binary data.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: {
+        type: "string",
+        description: "Path to save the file (supports ~ for home directory)"
+      },
+      contentBase64: {
+        type: "string",
+        description: "Base64 encoded file content"
+      },
+      overwrite: {
+        type: "boolean",
+        description: "Allow overwriting existing files (default: false)",
+        default: false
+      }
+    },
+    required: ["path", "contentBase64"]
+  }
+};
+
+export function handler(args) {
+  const { path: filePath, contentBase64, overwrite = false } = args;
+
+  if (!filePath) {
+    return {
+      success: false,
+      error: "path parameter is required"
+    };
+  }
+
+  if (!contentBase64) {
+    return {
+      success: false,
+      error: "contentBase64 parameter is required"
+    };
+  }
+
+  try {
+    // Expand ~ to home directory
+    let expandedPath = filePath;
+    if (filePath.startsWith('~')) {
+      expandedPath = path.join(os.homedir(), filePath.slice(1));
+    }
+
+    // Check if file exists and overwrite is false
+    if (!overwrite && fs.existsSync(expandedPath)) {
+      return {
+        success: false,
+        error: `File already exists: ${expandedPath}. Set overwrite: true to replace it.`
+      };
+    }
+
+    // Decode base64 content
+    const buffer = Buffer.from(contentBase64, 'base64');
+
+    // Ensure directory exists
+    const dir = path.dirname(expandedPath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+
+    // Write file
+    fs.writeFileSync(expandedPath, buffer);
+
+    return {
+      success: true,
+      path: expandedPath,
+      size: buffer.length,
+      message: `File saved successfully: ${expandedPath} (${buffer.length} bytes)`
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error.message
+    };
+  }
+}

package/src/tools/server-control.js

@@ -0,0 +1,52 @@
+/*
+ * server-control.js - HTTP server control tool
+ *
+ * Written by
+ *  Shawn Bullock <shawn@agenticexpert.ai>
+ */
+
+export const tool = {
+  name: "server_control",
+  description: "Control the AG-UI HTTP/HTTPS server (start, stop, restart)",
+  inputSchema: {
+    type: "object",
+    properties: {
+      action: {
+        type: "string",
+        enum: ["start", "stop", "restart", "status"],
+        description: "Action to perform",
+      },
+    },
+    required: ["action"],
+  },
+};
+
+export async function handler(args, httpServer) {
+  const { action } = args;
+
+  switch (action) {
+    case "start":
+      if (httpServer.getStatus().running) {
+        return { status: "already_running", ...httpServer.getStatus() };
+      }
+      await httpServer.start();
+      return { status: "started", ...httpServer.getStatus() };
+
+    case "stop":
+      if (!httpServer.getStatus().running) {
+        return { status: "already_stopped", ...httpServer.getStatus() };
+      }
+      await httpServer.stop();
+      return { status: "stopped", ...httpServer.getStatus() };
+
+    case "restart":
+      await httpServer.restart();
+      return { status: "restarted", ...httpServer.getStatus() };
+
+    case "status":
+      return httpServer.getStatus();
+
+    default:
+      throw new Error(`Unknown action: ${action}`);
+  }
+}

package/src/tools/set-debug.js

@@ -0,0 +1,33 @@
+/*
+ * set-debug.js - Debug mode control tool
+ *
+ * Written by
+ *  Shawn Bullock <shawn@agenticexpert.ai>
+ */
+
+export const tool = {
+  name: "set_debug",
+  description: "Enable or disable debug logging for the HTTP server",
+  inputSchema: {
+    type: "object",
+    properties: {
+      enabled: {
+        type: "boolean",
+        description: "True to enable debug logs, false to disable",
+      },
+    },
+    required: ["enabled"],
+  },
+};
+
+export async function handler(args, httpServer) {
+  const { enabled } = args;
+
+  httpServer.setDebug(enabled);
+
+  return {
+    status: "updated",
+    debug: enabled,
+    current: httpServer.getStatus(),
+  };
+}

package/src/tools/set-https.js

@@ -0,0 +1,34 @@
+/*
+ * set-https.js - HTTPS mode control tool
+ *
+ * Written by
+ *  Shawn Bullock <shawn@agenticexpert.ai>
+ */
+
+export const tool = {
+  name: "set_https",
+  description: "Enable or disable HTTPS mode for the server",
+  inputSchema: {
+    type: "object",
+    properties: {
+      enabled: {
+        type: "boolean",
+        description: "True for HTTPS, false for HTTP",
+      },
+    },
+    required: ["enabled"],
+  },
+};
+
+export async function handler(args, httpServer) {
+  const { enabled } = args;
+  const oldStatus = httpServer.getStatus();
+
+  await httpServer.setHttps(enabled);
+
+  return {
+    status: "updated",
+    previous: oldStatus,
+    current: httpServer.getStatus(),
+  };
+}

package/src/tools/show-window.js

@@ -0,0 +1,45 @@
+/*
+ * show-window.js - Show a window in the emulator
+ *
+ * Written by
+ *  Shawn Bullock <shawn@agenticexpert.ai>
+ */
+
+export const tool = {
+  name: "showWindow",
+  description: "Show and bring to front a window in the Apple //e emulator (e.g., disk-drives, basic-program)",
+  inputSchema: {
+    type: "object",
+    properties: {
+      windowId: {
+        type: "string",
+        description: "Window ID (e.g., 'disk-drives', 'basic-program', 'cpu-debugger')",
+      },
+    },
+    required: ["windowId"],
+  },
+};
+
+export async function handler(args, httpServer) {
+  const toolCallId = `tc_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+
+  await httpServer.sendEvent({
+    type: "TOOL_CALL_START",
+    tool_call_id: toolCallId,
+    tool_call_name: "showWindow",
+  });
+
+  await httpServer.sendEvent({
+    type: "TOOL_CALL_ARGS",
+    tool_call_id: toolCallId,
+    delta: JSON.stringify(args),
+  });
+
+  await httpServer.sendEvent({
+    type: "TOOL_CALL_END",
+    tool_call_id: toolCallId,
+  });
+
+  const result = await httpServer.waitForToolResult(toolCallId, 10000);
+  return result;
+}