talon-agent 1.3.0 → 1.4.0

package/src/plugins/github/index.ts

@@ -0,0 +1,106 @@
+/**
+ * GitHub plugin — GitHub API access via the official GitHub MCP server.
+ *
+ * Registers the GitHub MCP server (Docker image: ghcr.io/github/github-mcp-server),
+ * giving the agent access to repository management, issues, PRs, code search, etc.
+ *
+ * Configuration in ~/.talon/config.json:
+ *   "github": {
+ *     "enabled": true,
+ *     "token": "ghp_..."      // optional, defaults to `gh auth token` output
+ *   }
+ */
+
+import { execFileSync } from "node:child_process";
+import type { TalonPlugin } from "../../core/plugin.js";
+import { log, logWarn } from "../../util/log.js";
+
+/**
+ * Resolve a GitHub personal access token.
+ * Priority: explicit config > `gh auth token` CLI.
+ */
+function resolveToken(configToken?: string): string | undefined {
+  const trimmed = configToken?.trim();
+  if (trimmed) return trimmed;
+  try {
+    return execFileSync("gh", ["auth", "token"], {
+      timeout: 5_000,
+      stdio: ["pipe", "pipe", "pipe"],
+    })
+      .toString("utf-8")
+      .trim();
+  } catch {
+    return undefined;
+  }
+}
+
+export function createGitHubPlugin(config: { token?: string }): TalonPlugin {
+  const token = resolveToken(config.token);
+
+  return {
+    name: "github",
+    description: "GitHub API access via the official GitHub MCP server",
+    version: "1.0.0",
+
+    mcpServer: {
+      command: "docker",
+      args: [
+        "run",
+        "--rm",
+        "-i",
+        "-e",
+        "GITHUB_PERSONAL_ACCESS_TOKEN",
+        "ghcr.io/github/github-mcp-server",
+      ],
+    },
+
+    validateConfig() {
+      const errors: string[] = [];
+
+      if (!token) {
+        errors.push(
+          'No GitHub token found. Set "token" in github config or run `gh auth login`.',
+        );
+      }
+
+      // Check Docker is available
+      try {
+        execFileSync("docker", ["info"], {
+          timeout: 10_000,
+          stdio: "pipe",
+        });
+      } catch {
+        errors.push(
+          "Docker is not available or not running. The GitHub MCP server requires Docker.",
+        );
+      }
+
+      return errors.length > 0 ? errors : undefined;
+    },
+
+    async init() {
+      // Verify the Docker image exists locally
+      try {
+        execFileSync(
+          "docker",
+          ["image", "inspect", "ghcr.io/github/github-mcp-server"],
+          { timeout: 10_000, stdio: "pipe" },
+        );
+        log("github", "Docker image verified");
+      } catch {
+        logWarn(
+          "github",
+          "Docker image not found locally — will pull on first use (may be slow)",
+        );
+      }
+
+      log("github", "Ready");
+    },
+
+    getEnvVars() {
+      return {
+        ...(token ? { GITHUB_PERSONAL_ACCESS_TOKEN: token } : {}),
+      };
+    },
+  };
+}

package/src/plugins/playwright/index.ts

@@ -0,0 +1,82 @@
+/**
+ * Playwright plugin — browser automation via the official Playwright MCP server.
+ *
+ * Gives the agent headless Chromium for web scraping, screenshots, PDF generation,
+ * and general browser automation.
+ *
+ * Configuration in ~/.talon/config.json:
+ *   "playwright": {
+ *     "enabled": true,
+ *     "browser": "chromium",     // optional, default "chromium"
+ *     "headless": true           // optional, default true
+ *   }
+ */
+
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import type { TalonPlugin } from "../../core/plugin.js";
+import { log } from "../../util/log.js";
+
+export function createPlaywrightPlugin(config: {
+  browser?: string;
+  headless?: boolean;
+}): TalonPlugin {
+  const browser = config.browser ?? "chromium";
+  const headless = config.headless !== false; // default true
+
+  // Resolve path from Talon's node_modules
+  const mcpBin = resolve(
+    import.meta.dirname ?? ".",
+    "../../../node_modules/@playwright/mcp/cli.js",
+  );
+
+  const args = ["--no-sandbox"];
+
+  if (headless) {
+    args.push("--headless");
+  }
+
+  if (browser !== "chromium") {
+    args.push("--browser", browser);
+  }
+
+  return {
+    name: "playwright",
+    description: "Browser automation via Playwright MCP (headless Chromium)",
+    version: "1.0.0",
+
+    mcpServer: {
+      command: "node",
+      args: [mcpBin, ...args],
+    },
+
+    validateConfig() {
+      const errors: string[] = [];
+
+      const validBrowsers = [
+        "chromium",
+        "chrome",
+        "firefox",
+        "webkit",
+        "msedge",
+      ];
+      if (!validBrowsers.includes(browser)) {
+        errors.push(
+          `Invalid browser "${browser}". Valid options: ${validBrowsers.join(", ")}`,
+        );
+      }
+
+      if (!existsSync(mcpBin)) {
+        errors.push(
+          `@playwright/mcp not found at ${mcpBin} — run "npm install @playwright/mcp"`,
+        );
+      }
+
+      return errors.length > 0 ? errors : undefined;
+    },
+
+    async init() {
+      log("playwright", `Ready (${browser}, headless=${headless})`);
+    },
+  };
+}

package/src/storage/sessions.ts

@@ -82,16 +82,6 @@ export function loadSessions(): void {
     );
     store = {};
   }
-  // SDK sessions don't survive process restarts — the embedded Claude Code
-  // subprocess is gone.  Clear stale session IDs so we don't try to resume
-  // a dead session (which causes the SDK to hang silently on Windows).
-  // Keep turns/usage intact — they're historical data used by /resume.
-  for (const session of Object.values(store)) {
-    if (session.sessionId) {
-      session.sessionId = undefined;
-      dirty = true;
-    }
-  }
 }
 
 function saveSessions(): void {

package/src/util/config.ts

@@ -40,10 +40,18 @@ const configSchema = z.object({
   heartbeatIntervalMinutes: z.number().int().min(5).default(60),
   heartbeatModel: z.string().optional(), // Model for heartbeat agent (defaults to main model)
   braveApiKey: z.string().optional(),
-  searxngUrl: z.string().default("http://localhost:8080"),
   timezone: z.string().optional(),
   plugins: z.array(pluginEntrySchema).default([]),
 
+  // GitHub — GitHub API access via official MCP server
+  github: z
+    .object({
+      enabled: z.boolean().default(false),
+      /** GitHub personal access token (default: from `gh auth token`) */
+      token: z.string().min(1).optional(),
+    })
+    .optional(),
+
   // MemPalace — structured long-term memory with vector search
   mempalace: z
     .object({
@@ -55,6 +63,17 @@ const configSchema = z.object({
     })
     .optional(),
 
+  // Playwright — headless browser automation via MCP
+  playwright: z
+    .object({
+      enabled: z.boolean().default(false),
+      /** Browser engine: chromium (default), chrome, firefox, webkit, msedge */
+      browser: z.string().optional(),
+      /** Run headless (default: true) */
+      headless: z.boolean().default(true),
+    })
+    .optional(),
+
   // Display name shown in terminal UI (defaults to "Talon")
   botDisplayName: z.string().default("Talon"),
 

package/src/util/log.ts

@@ -42,7 +42,9 @@ export type LogComponent =
   | "teams"
   | "config"
   | "access"
-  | "mempalace";
+  | "github"
+  | "mempalace"
+  | "playwright";
 
 const LOG_FILE = files.log;