changelog 2025-10-24 (#540)

Author: evantahler

agents/changelog/agents/changelog.ts

@@ -1,9 +1,9 @@
 import { WrappedAgent } from "../classes/wrapped-agent";
 import type { Config } from "../classes/config";
 import type { Logger } from "../classes/logger";
+import { appendChangelogEntryTool } from "../tools/append-changelog-entry";
 import { getNewCommitsTool } from "../tools/get-new-commits-and-prs";
 import { readFileTool } from "../tools/read-file";
-import { writeFileTool } from "../tools/write-file";
 
 export class ChangelogAgent extends WrappedAgent {
   constructor(config: Config, logger: Logger) {
@@ -28,7 +28,7 @@ There are 4 possible types of changes, which each have an emoji associated with
 The steps to follow are:
 1. Load the changelog file and note the date of the most recent entry.
 2. Load all new commits since the most recent entry in the changelog file from the provided Github repositories.
-3. Append the changes to the changelog file. Do not alter the older entries in the changelog - ONLY APPEND NEW ENTRIES. Do not ask the user for confirmation. The changelog should be in the same format as the changelog file.  Do not include any other text in the changelog file.  Do not combine multiple changes into a single entry.
+3. Append the changes to the changelog file. Do not alter the older entries in the changelog - ONLY APPEND NEW ENTRIES. Do not ask the user for confirmation. The changelog should be in the same format as the changelog file. Do not include any other text in the changelog file. Do not combine multiple changes into a single entry EXCEPT when there are changes in the docs repo that relate to another repo - those should be combined into a single entry for the non-docs repo.
 
 When updating the changelog, follow these rules:
   - The date to use for the changelog is always the most recent Friday.
@@ -40,7 +40,7 @@ When updating the changelog, follow these rules:
 
     const tools = [
       readFileTool(config, logger),
-      writeFileTool(config, logger),
+      appendChangelogEntryTool(config, logger),
       getNewCommitsTool(config, logger),
     ];
 

agents/changelog/tools/append-changelog-entry.ts

@@ -0,0 +1,77 @@
+import { tool } from '@openai/agents';
+import * as fs from 'fs';
+import path from 'path';
+import { z } from 'zod';
+
+import type { Config } from '../classes/config';
+import type { Logger } from '../classes/logger';
+import { ToolUtils } from '../utils/tool-utils';
+
+const name = 'append_changelog_entry';
+const description = 'Append a changelog entry to a file with a date and body text';
+const parametersSchema = z.object({
+  path: z.string().describe('The path to the changelog file'),
+  date: z.string().describe('The date for the changelog entry (e.g., YYYY-MM-DD)'),
+  body: z.string().describe('The body text of the changelog entry'),
+});
+
+export const appendChangelogEntryTool = (config: Config, logger: Logger) =>
+  tool({
+    name,
+    description,
+    parameters: parametersSchema,
+    execute: ToolUtils.wrappedExecute(name, execute, config, logger),
+  });
+
+export async function execute(
+  parameters: z.infer<typeof parametersSchema>,
+  config: Config
+) {
+  try {
+    // Resolve the target path relative to the configured directory
+    const targetPath = path.resolve(parameters.path);
+    const configDir = path.resolve(config.directory);
+
+    // Check if the target path is outside the configured directory
+    if (!targetPath.startsWith(configDir)) {
+      return `Error appending changelog entry: Cannot write outside configured directory ${configDir}`;
+    }
+
+    // Check if the file exists
+    if (!fs.existsSync(targetPath)) {
+      return `Error appending changelog entry: File does not exist: ${parameters.path}`;
+    }
+
+    // Read the current file content
+    const currentContent = fs.readFileSync(targetPath, 'utf-8');
+
+    // Format the changelog entry
+    const entry = `## ${parameters.date}\n\n${parameters.body}\n\n`;
+
+    // Find the first occurrence of ## (latest entry)
+    const firstH2Index = currentContent.indexOf('## ');
+
+    let newContent: string;
+    if (firstH2Index !== -1) {
+      // Insert the new entry before the latest entry
+      newContent =
+        currentContent.slice(0, firstH2Index) +
+        entry +
+        currentContent.slice(firstH2Index);
+    } else {
+      // No existing entries, append to the end
+      newContent = currentContent + '\n' + entry;
+    }
+
+    // Write the updated content
+    fs.writeFileSync(targetPath, newContent, 'utf-8');
+
+    return `Changelog entry inserted successfully to ${parameters.path}`;
+  } catch (error: unknown) {
+    if (error instanceof Error) {
+      return `Error appending changelog entry: ${error.message}`;
+    }
+    return `Error appending changelog entry: ${error}`;
+  }
+}
+

app/en/home/changelog/page.mdx

@@ -9,6 +9,22 @@ import { Callout } from "nextra/components";
 
 _Here's what's new at Arcade.dev!_
 
+## 2025-10-24
+
+**Toolkits**
+
+- `[feature - 🚀]` [Toolkits/Ticktick] Added Ticktick Starter Toolkit
+- `[feature - 🚀]` [Toolkits/Weaviate] Added Weaviate Starter Toolkit
+- `[feature - 🚀]` [Toolkits/Vercel] Added Vercel Starter Toolkit
+- `[feature - 🚀]` [Toolkits/Datadog] Added Datadog Starter Toolkit
+- `[feature - 🚀]` [Toolkits/Freshservice] New Freshservice MCP tools with complex objects handling
+
+**Platform and Engine**
+
+- `[feature - 🚀]` Dashboard: Add redirect_uri to MCP Servers
+- `[feature - 🚀]` Dashboard: Add OAuth fields to MCP Servers
+
+
 ## 2025-10-17
 
 <Callout type="important">