freeturtle 0.1.0

package/dist/src/logger.js

@@ -0,0 +1,45 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+const LEVEL_ORDER = ["debug", "info", "warn", "error"];
+export function createLogger(dir) {
+    const logDir = join(tmpdir(), "freeturtle");
+    const logPath = dir ? join(logDir, "freeturtle.log") : null;
+    let logFileReady = false;
+    function formatLine(level, msg) {
+        const ts = new Date().toISOString();
+        return `[${ts}] [${level.toUpperCase()}] ${msg}`;
+    }
+    async function writeToFile(line) {
+        if (!logPath)
+            return;
+        if (!logFileReady) {
+            await mkdir(logDir, { recursive: true });
+            logFileReady = true;
+        }
+        await appendFile(logPath, line + "\n", "utf-8");
+    }
+    function log(level, msg) {
+        const minLevel = "debug";
+        if (LEVEL_ORDER.indexOf(level) < LEVEL_ORDER.indexOf(minLevel))
+            return;
+        const line = formatLine(level, msg);
+        // Only print errors/warnings to stderr; all else goes to log file only
+        if (level === "error") {
+            console.error(line);
+        }
+        else if (level === "warn") {
+            console.warn(line);
+        }
+        writeToFile(line).catch(() => {
+            // Silently ignore log file write failures
+        });
+    }
+    return {
+        debug: (msg) => log("debug", msg),
+        info: (msg) => log("info", msg),
+        warn: (msg) => log("warn", msg),
+        error: (msg) => log("error", msg),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAWjC,MAAM,WAAW,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnE,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,SAAS,UAAU,CAAC,KAAe,EAAE,GAAW;QAC9C,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,IAAI,EAAE,MAAM,KAAK,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,UAAU,WAAW,CAAC,IAAY;QACrC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,MAAM,UAAU,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,SAAS,GAAG,CAAC,KAAe,EAAE,GAAW;QACvC,MAAM,QAAQ,GAAa,OAAO,CAAC;QACnC,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO;QAEvE,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAEpC,uEAAuE;QACvE,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC3B,0CAA0C;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC;QACzC,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;QACvC,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;QACvC,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/src/memory.d.ts

@@ -0,0 +1,3 @@
+export declare function readMemoryFile(dir: string, filename: string): Promise<string | null>;
+export declare function writeMemoryFile(dir: string, filename: string, content: string): Promise<void>;
+export declare function appendToJsonArray(dir: string, filename: string, entry: unknown): Promise<void>;

package/dist/src/memory.js

@@ -0,0 +1,36 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+function memoryPath(dir, filename) {
+    return join(dir, "workspace", "memory", filename);
+}
+export async function readMemoryFile(dir, filename) {
+    try {
+        return await readFile(memoryPath(dir, filename), "utf-8");
+    }
+    catch (err) {
+        if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+            return null;
+        }
+        throw err;
+    }
+}
+export async function writeMemoryFile(dir, filename, content) {
+    const filePath = memoryPath(dir, filename);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, content, "utf-8");
+}
+export async function appendToJsonArray(dir, filename, entry) {
+    const existing = await readMemoryFile(dir, filename);
+    let arr;
+    try {
+        arr = existing ? JSON.parse(existing) : [];
+    }
+    catch {
+        arr = [];
+    }
+    if (!Array.isArray(arr))
+        arr = [];
+    arr.push(entry);
+    await writeMemoryFile(dir, filename, JSON.stringify(arr, null, 2));
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,SAAS,UAAU,CAAC,GAAW,EAAE,QAAgB;IAC/C,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,QAAgB;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9F,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,QAAgB,EAAE,OAAe;IAClF,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,QAAgB,EAAE,KAAc;IACnF,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,GAAc,CAAC;IACnB,IAAI,CAAC;QACH,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,EAAE,CAAC;IACX,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,EAAE,CAAC;IAClC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,MAAM,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/src/modules/database/client.d.ts

@@ -0,0 +1,18 @@
+export interface QueryResult {
+    rows: Record<string, unknown>[];
+    rowCount: number;
+}
+export interface TableInfo {
+    table_name: string;
+    columns: {
+        name: string;
+        type: string;
+    }[];
+}
+export declare class DatabaseClient {
+    private pool;
+    constructor(connectionString: string);
+    query(sql: string): Promise<QueryResult>;
+    listTables(): Promise<TableInfo[]>;
+    close(): Promise<void>;
+}

package/dist/src/modules/database/client.js

@@ -0,0 +1,50 @@
+import pg from "pg";
+export class DatabaseClient {
+    pool;
+    constructor(connectionString) {
+        this.pool = new pg.Pool({ connectionString });
+    }
+    async query(sql) {
+        const client = await this.pool.connect();
+        try {
+            await client.query("BEGIN TRANSACTION READ ONLY");
+            const result = await client.query(sql);
+            await client.query("COMMIT");
+            return {
+                rows: result.rows,
+                rowCount: result.rowCount ?? 0,
+            };
+        }
+        catch (err) {
+            await client.query("ROLLBACK");
+            throw err;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async listTables() {
+        const tablesResult = await this.query(`SELECT table_name FROM information_schema.tables
+       WHERE table_schema = 'public'
+       ORDER BY table_name`);
+        const tables = [];
+        for (const row of tablesResult.rows) {
+            const tableName = row.table_name;
+            const colsResult = await this.query(`SELECT column_name, data_type FROM information_schema.columns
+         WHERE table_schema = 'public' AND table_name = '${tableName.replace(/'/g, "''")}'
+         ORDER BY ordinal_position`);
+            tables.push({
+                table_name: tableName,
+                columns: colsResult.rows.map((c) => ({
+                    name: c.column_name,
+                    type: c.data_type,
+                })),
+            });
+        }
+        return tables;
+    }
+    async close() {
+        await this.pool.end();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/modules/database/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/modules/database/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAYpB,MAAM,OAAO,cAAc;IACjB,IAAI,CAAU;IAEtB,YAAY,gBAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW;QACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7B,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAiC;gBAC9C,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC/B,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,KAAK,CACnC;;2BAEqB,CACtB,CAAC;QAEF,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,GAAG,CAAC,UAAoB,CAAC;YAC3C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CACjC;2DACmD,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;mCACrD,CAC5B,CAAC;YACF,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACnC,IAAI,EAAE,CAAC,CAAC,WAAqB;oBAC7B,IAAI,EAAE,CAAC,CAAC,SAAmB;iBAC5B,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/src/modules/database/index.d.ts

@@ -0,0 +1,9 @@
+import type { FreeTurtleModule, ToolDefinition } from "../types.js";
+export declare class DatabaseModule implements FreeTurtleModule {
+    name: string;
+    description: string;
+    private client;
+    initialize(_config: Record<string, unknown>, env: Record<string, string>): Promise<void>;
+    getTools(): ToolDefinition[];
+    executeTool(name: string, input: Record<string, unknown>): Promise<string>;
+}

package/dist/src/modules/database/index.js

@@ -0,0 +1,32 @@
+import { withRetry } from "../../reliability.js";
+import { DatabaseClient } from "./client.js";
+import { databaseTools } from "./tools.js";
+export class DatabaseModule {
+    name = "database";
+    description = "Query a PostgreSQL database (read-only).";
+    client;
+    async initialize(_config, env) {
+        const url = env.DATABASE_URL;
+        if (!url)
+            throw new Error("Database module requires DATABASE_URL");
+        this.client = new DatabaseClient(url);
+    }
+    getTools() {
+        return databaseTools;
+    }
+    async executeTool(name, input) {
+        switch (name) {
+            case "query_database": {
+                const result = await withRetry(() => this.client.query(input.sql));
+                return JSON.stringify({ rowCount: result.rowCount, rows: result.rows });
+            }
+            case "list_tables": {
+                const tables = await withRetry(() => this.client.listTables());
+                return JSON.stringify(tables);
+            }
+            default:
+                throw new Error(`Unknown database tool: ${name}`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/modules/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/database/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,OAAO,cAAc;IACzB,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,0CAA0C,CAAC;IAEjD,MAAM,CAAkB;IAEhC,KAAK,CAAC,UAAU,CACd,OAAgC,EAChC,GAA2B;QAE3B,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC;QAC7B,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ;QACN,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,WAAW,CACf,IAAY,EACZ,KAA8B;QAE9B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAa,CAAC,CACvC,CAAC;gBACF,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YACD;gBACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CACF"}

package/dist/src/modules/database/tools.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from "../types.js";
+export declare const databaseTools: ToolDefinition[];

package/dist/src/modules/database/tools.js

@@ -0,0 +1,26 @@
+export const databaseTools = [
+    {
+        name: "query_database",
+        description: "Execute a read-only SQL query against the connected PostgreSQL database. Returns results as JSON. Only SELECT queries are allowed.",
+        input_schema: {
+            type: "object",
+            properties: {
+                sql: {
+                    type: "string",
+                    description: "The SQL query to execute (SELECT only)",
+                },
+            },
+            required: ["sql"],
+        },
+    },
+    {
+        name: "list_tables",
+        description: "List all tables in the database with their column names and types.",
+        input_schema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/src/modules/database/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../src/modules/database/tools.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,oIAAoI;QACtI,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wCAAwC;iBACtD;aACF;YACD,QAAQ,EAAE,CAAC,KAAK,CAAC;SAClB;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,oEAAoE;QACtE,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC"}

package/dist/src/modules/farcaster/client.d.ts

@@ -0,0 +1,43 @@
+export interface CastResponse {
+    success: boolean;
+    cast: {
+        hash: string;
+        author: {
+            fid: number;
+        };
+        text: string;
+    };
+}
+export interface Cast {
+    hash: string;
+    text: string;
+    timestamp: string;
+    author: {
+        fid: number;
+        username: string;
+        display_name: string;
+    };
+    reactions: {
+        likes_count: number;
+        recasts_count: number;
+    };
+    replies: {
+        count: number;
+    };
+}
+export declare class NeynarClient {
+    private apiKey;
+    private signerUuid;
+    constructor(apiKey: string, signerUuid: string);
+    postCast(text: string, options?: {
+        channelId?: string;
+        parent?: string;
+        embeds?: string[];
+    }): Promise<CastResponse>;
+    getCasts(channelId: string, limit?: number): Promise<Cast[]>;
+    getMentions(fid: number, limit?: number): Promise<Cast[]>;
+    replyCast(parentHash: string, text: string): Promise<CastResponse>;
+    deleteCast(targetHash: string): Promise<{
+        success: boolean;
+    }>;
+}

package/dist/src/modules/farcaster/client.js

@@ -0,0 +1,87 @@
+const BASE_URL = "https://api.neynar.com/v2/farcaster";
+export class NeynarClient {
+    apiKey;
+    signerUuid;
+    constructor(apiKey, signerUuid) {
+        this.apiKey = apiKey;
+        this.signerUuid = signerUuid;
+    }
+    async postCast(text, options) {
+        const body = {
+            signer_uuid: this.signerUuid,
+            text,
+        };
+        if (options?.channelId)
+            body.channel_id = options.channelId;
+        if (options?.parent)
+            body.parent = options.parent;
+        if (options?.embeds) {
+            body.embeds = options.embeds.map((url) => ({ url }));
+        }
+        const res = await fetch(`${BASE_URL}/cast`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": this.apiKey,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`Neynar postCast failed (${res.status}): ${err}`);
+        }
+        return (await res.json());
+    }
+    async getCasts(channelId, limit = 10) {
+        const params = new URLSearchParams({
+            channel_ids: channelId,
+            limit: String(limit),
+        });
+        const res = await fetch(`${BASE_URL}/feed/channels?${params}`, {
+            headers: { "x-api-key": this.apiKey },
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`Neynar getCasts failed (${res.status}): ${err}`);
+        }
+        const data = (await res.json());
+        return data.casts;
+    }
+    async getMentions(fid, limit = 10) {
+        const params = new URLSearchParams({
+            fid: String(fid),
+            limit: String(limit),
+        });
+        const res = await fetch(`${BASE_URL}/notifications?${params}`, {
+            headers: { "x-api-key": this.apiKey },
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`Neynar getMentions failed (${res.status}): ${err}`);
+        }
+        const data = (await res.json());
+        return data.notifications;
+    }
+    async replyCast(parentHash, text) {
+        return this.postCast(text, { parent: parentHash });
+    }
+    async deleteCast(targetHash) {
+        const res = await fetch(`${BASE_URL}/cast`, {
+            method: "DELETE",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": this.apiKey,
+            },
+            body: JSON.stringify({
+                signer_uuid: this.signerUuid,
+                target_hash: targetHash,
+            }),
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`Neynar deleteCast failed (${res.status}): ${err}`);
+        }
+        return { success: true };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/modules/farcaster/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/modules/farcaster/client.ts"],"names":[],"mappings":"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"}

package/dist/src/modules/farcaster/index.d.ts

@@ -0,0 +1,14 @@
+import type { FreeTurtleModule, ToolDefinition } from "../types.js";
+import type { PolicyConfig } from "../../policy.js";
+export declare class FarcasterModule implements FreeTurtleModule {
+    name: string;
+    description: string;
+    private client;
+    private fid;
+    private policy?;
+    initialize(_config: Record<string, unknown>, env: Record<string, string>, options?: {
+        policy?: PolicyConfig;
+    }): Promise<void>;
+    getTools(): ToolDefinition[];
+    executeTool(name: string, input: Record<string, unknown>): Promise<string>;
+}

package/dist/src/modules/farcaster/index.js

@@ -0,0 +1,71 @@
+import { assertFarcasterChannelAllowed } from "../../policy.js";
+import { withRetry } from "../../reliability.js";
+import { NeynarClient } from "./client.js";
+import { farcasterTools } from "./tools.js";
+export class FarcasterModule {
+    name = "farcaster";
+    description = "Post and read casts on Farcaster via the Neynar API.";
+    client;
+    fid;
+    policy;
+    async initialize(_config, env, options) {
+        const apiKey = env.NEYNAR_API_KEY;
+        const signerUuid = env.FARCASTER_SIGNER_UUID;
+        const fid = env.FARCASTER_FID;
+        if (!apiKey)
+            throw new Error("Farcaster module requires NEYNAR_API_KEY");
+        if (!signerUuid)
+            throw new Error("Farcaster module requires FARCASTER_SIGNER_UUID");
+        this.client = new NeynarClient(apiKey, signerUuid);
+        this.fid = fid ? parseInt(fid, 10) : 0;
+        this.policy = options?.policy;
+    }
+    getTools() {
+        return farcasterTools;
+    }
+    async executeTool(name, input) {
+        // Enforce channel allowlist for channel-scoped operations
+        if (input.channel_id) {
+            assertFarcasterChannelAllowed(this.policy, input.channel_id);
+        }
+        switch (name) {
+            case "post_cast": {
+                const result = await withRetry(() => this.client.postCast(input.text, {
+                    channelId: input.channel_id,
+                    embeds: input.embeds,
+                }));
+                return JSON.stringify(result);
+            }
+            case "read_channel": {
+                const casts = await withRetry(() => this.client.getCasts(input.channel_id, input.limit ?? 10));
+                const summary = casts.map((c) => ({
+                    hash: c.hash,
+                    author: c.author.display_name || c.author.username,
+                    text: c.text,
+                    likes: c.reactions.likes_count,
+                    recasts: c.reactions.recasts_count,
+                    replies: c.replies.count,
+                    timestamp: c.timestamp,
+                }));
+                return JSON.stringify(summary);
+            }
+            case "read_mentions": {
+                if (!this.fid)
+                    return "Error: FARCASTER_FID not set, cannot read mentions.";
+                const mentions = await withRetry(() => this.client.getMentions(this.fid, input.limit ?? 10));
+                return JSON.stringify(mentions);
+            }
+            case "reply_to_cast": {
+                const result = await withRetry(() => this.client.replyCast(input.parent_hash, input.text));
+                return JSON.stringify(result);
+            }
+            case "delete_cast": {
+                const result = await withRetry(() => this.client.deleteCast(input.target_hash));
+                return JSON.stringify(result);
+            }
+            default:
+                throw new Error(`Unknown farcaster tool: ${name}`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/modules/farcaster/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/farcaster/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,OAAO,eAAe;IAC1B,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,sDAAsD,CAAC;IAE7D,MAAM,CAAgB;IACtB,GAAG,CAAU;IACb,MAAM,CAAgB;IAE9B,KAAK,CAAC,UAAU,CACd,OAAgC,EAChC,GAA2B,EAC3B,OAAmC;QAEnC,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC;QAClC,MAAM,UAAU,GAAG,GAAG,CAAC,qBAAqB,CAAC;QAC7C,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC;QAE9B,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QACzE,IAAI,CAAC,UAAU;YACb,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAErE,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAChC,CAAC;IAED,QAAQ;QACN,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,WAAW,CACf,IAAY,EACZ,KAA8B;QAE9B,0DAA0D;QAC1D,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,6BAA6B,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,UAAoB,CAAC,CAAC;QACzE,CAAC;QAED,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAc,EAAE;oBACzC,SAAS,EAAE,KAAK,CAAC,UAAgC;oBACjD,MAAM,EAAE,KAAK,CAAC,MAA8B;iBAC7C,CAAC,CACH,CAAC;gBACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAClB,KAAK,CAAC,UAAoB,EACzB,KAAK,CAAC,KAAgB,IAAI,EAAE,CAC9B,CACF,CAAC;gBACF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ;oBAClD,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW;oBAC9B,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa;oBAClC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK;oBACxB,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC,CAAC,CAAC;gBACJ,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;YAED,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,GAAG;oBAAE,OAAO,qDAAqD,CAAC;gBAC5E,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CACpC,IAAI,CAAC,MAAM,CAAC,WAAW,CACrB,IAAI,CAAC,GAAG,EACP,KAAK,CAAC,KAAgB,IAAI,EAAE,CAC9B,CACF,CAAC;gBACF,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;YAED,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CACnB,KAAK,CAAC,WAAqB,EAC3B,KAAK,CAAC,IAAc,CACrB,CACF,CAAC;gBACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAClC,IAAI,CAAC,MAAM,CAAC,UAAU,CACpB,KAAK,CAAC,WAAqB,CAC5B,CACF,CAAC;gBACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED;gBACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF"}

package/dist/src/modules/farcaster/tools.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from "../types.js";
+export declare const farcasterTools: ToolDefinition[];

package/dist/src/modules/farcaster/tools.js

@@ -0,0 +1,90 @@
+export const farcasterTools = [
+    {
+        name: "post_cast",
+        description: "Post a cast (message) to Farcaster. Optionally post to a specific channel or include embed URLs.",
+        input_schema: {
+            type: "object",
+            properties: {
+                text: {
+                    type: "string",
+                    description: "The text content of the cast (max 1024 characters)",
+                },
+                channel_id: {
+                    type: "string",
+                    description: "Optional channel to post to (e.g. 'tortoise')",
+                },
+                embeds: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional list of URLs to embed (max 2)",
+                },
+            },
+            required: ["text"],
+        },
+    },
+    {
+        name: "read_channel",
+        description: "Read recent casts from a Farcaster channel. Returns the latest posts with author, text, reactions, and reply counts.",
+        input_schema: {
+            type: "object",
+            properties: {
+                channel_id: {
+                    type: "string",
+                    description: "The channel to read from (e.g. 'tortoise')",
+                },
+                limit: {
+                    type: "number",
+                    description: "Number of casts to return (default 10, max 100)",
+                },
+            },
+            required: ["channel_id"],
+        },
+    },
+    {
+        name: "read_mentions",
+        description: "Read recent notifications and mentions for the CEO's Farcaster account.",
+        input_schema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "Number of mentions to return (default 10, max 100)",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "reply_to_cast",
+        description: "Reply to a specific cast on Farcaster by its hash.",
+        input_schema: {
+            type: "object",
+            properties: {
+                parent_hash: {
+                    type: "string",
+                    description: "The hash of the cast to reply to",
+                },
+                text: {
+                    type: "string",
+                    description: "The text content of the reply",
+                },
+            },
+            required: ["parent_hash", "text"],
+        },
+    },
+    {
+        name: "delete_cast",
+        description: "Delete a cast by its hash. This action requires founder approval and cannot be undone.",
+        input_schema: {
+            type: "object",
+            properties: {
+                target_hash: {
+                    type: "string",
+                    description: "The hash of the cast to delete",
+                },
+            },
+            required: ["target_hash"],
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/src/modules/farcaster/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../src/modules/farcaster/tools.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,kGAAkG;QACpG,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,wCAAwC;iBACtD;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,sHAAsH;QACxH,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iDAAiD;iBAC/D;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,yEAAyE;QAC3E,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,oDAAoD;QACtD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kCAAkC;iBAChD;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC;SAClC;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,wFAAwF;QAC1F,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;KACF;CACF,CAAC"}

package/dist/src/modules/github/client.d.ts

@@ -0,0 +1,21 @@
+export interface Issue {
+    number: number;
+    title: string;
+    body: string | null;
+    state: string;
+    html_url: string;
+    created_at: string;
+    user: string;
+}
+export interface CommitResult {
+    sha: string;
+    html_url: string;
+}
+export declare class GitHubClient {
+    private octokit;
+    constructor(token: string);
+    private parseRepo;
+    createIssue(repo: string, title: string, body: string): Promise<Issue>;
+    listIssues(repo: string, state?: "open" | "closed" | "all"): Promise<Issue[]>;
+    commitFile(repo: string, path: string, content: string, message: string, branch?: string): Promise<CommitResult>;
+}