@ugm/desiagent 0.1.21

package/dist/core/tools/sendEmail.js

@@ -0,0 +1,132 @@
+/**
+ * Send Email Tool
+ *
+ * Send emails via SMTP with optional CC, BCC, and attachments
+ */
+import { z } from 'zod';
+import nodemailer from 'nodemailer';
+import { BaseTool } from './base.js';
+import path from 'node:path';
+const attachmentSchema = z.object({
+    filename: z.string().describe('Display name for the attachment'),
+    path: z.string().optional().describe('File path to attach (use this OR content, not both)'),
+    content: z.string().optional().describe('Base64-encoded content or plain text (use this OR path, not both)'),
+    contentType: z.string().optional().describe('MIME type (e.g., "application/pdf", "image/png")'),
+    encoding: z.enum(['base64', 'utf-8']).optional().describe('Content encoding if using content field'),
+});
+const sendEmailInputSchema = z.object({
+    to: z.string().email().describe('Recipient email address'),
+    subject: z.string().describe('Email subject line'),
+    body: z.string().describe('Email body content (plain text or HTML)'),
+    cc: z.union([
+        z.string().email(),
+        z.array(z.string().email()),
+    ]).optional().describe('CC email address(es) - single email or array of emails'),
+    bcc: z.union([
+        z.string().email(),
+        z.array(z.string().email()),
+    ]).optional().describe('BCC email address(es) - single email or array of emails'),
+    html: z.boolean().optional().default(false).describe('Whether body is HTML (default: false)'),
+    attachments: z.array(attachmentSchema).optional().describe('File attachments'),
+});
+export class SendEmailTool extends BaseTool {
+    name = 'sendEmail';
+    description = 'Send an email via SMTP with optional CC, BCC, and attachments. Requires SMTP configuration in environment variables.';
+    inputSchema = sendEmailInputSchema;
+    transporter = null;
+    resolveAttachmentPath(filePath, ctx) {
+        const artifactsDir = ctx.artifactsDir || process.env.ARTIFACTS_DIR || './artifacts';
+        return path.resolve(artifactsDir, path.basename(filePath));
+    }
+    getTransporter() {
+        if (this.transporter) {
+            return this.transporter;
+        }
+        const smtpHost = process.env.SMTP_HOST;
+        const smtpPort = process.env.SMTP_PORT ? parseInt(process.env.SMTP_PORT, 10) : 587;
+        const smtpUser = process.env.SMTP_USER;
+        const smtpPass = process.env.SMTP_PASS;
+        const smtpFrom = process.env.SMTP_FROM;
+        if (!smtpHost || !smtpUser || !smtpPass || !smtpFrom) {
+            throw new Error('Email configuration missing. Required env vars: SMTP_HOST, SMTP_USER, SMTP_PASS, SMTP_FROM');
+        }
+        this.transporter = nodemailer.createTransport({
+            host: smtpHost,
+            port: smtpPort,
+            secure: smtpPort === 465,
+            auth: {
+                user: smtpUser,
+                pass: smtpPass,
+            },
+        });
+        return this.transporter;
+    }
+    normalizeEmailList(emails) {
+        if (!emails)
+            return undefined;
+        if (Array.isArray(emails)) {
+            return emails.join(', ');
+        }
+        return emails;
+    }
+    async execute(input, ctx) {
+        ctx.logger.info(`Sending email to: ${input.to}`);
+        try {
+            const transporter = this.getTransporter();
+            const from = process.env.SMTP_FROM;
+            const mailOptions = {
+                from,
+                to: input.to,
+                subject: input.subject,
+            };
+            if (input.html) {
+                mailOptions.html = input.body;
+            }
+            else {
+                mailOptions.text = input.body;
+            }
+            const cc = this.normalizeEmailList(input.cc);
+            if (cc) {
+                mailOptions.cc = cc;
+            }
+            const bcc = this.normalizeEmailList(input.bcc);
+            if (bcc) {
+                mailOptions.bcc = bcc;
+            }
+            if (input.attachments && input.attachments.length > 0) {
+                mailOptions.attachments = input.attachments.map((att) => ({
+                    filename: att.filename,
+                    path: att.path ? this.resolveAttachmentPath(att.path, ctx) : undefined,
+                    content: att.content,
+                    contentType: att.contentType,
+                    encoding: att.encoding,
+                }));
+                ctx.logger.info(`Adding ${input.attachments.length} attachment(s)`);
+            }
+            const result = await this.retry(async () => {
+                return await this.withTimeout(transporter.sendMail(mailOptions), 30000, 'Email send timed out');
+            }, 3, 2000);
+            ctx.logger.info(`Email sent successfully. Message ID: ${result.messageId}`);
+            ctx.emitEvent?.completed?.(`✉️ Email sent`);
+            return {
+                success: true,
+                messageId: result.messageId,
+                to: input.to,
+                subject: input.subject,
+                attachmentCount: input.attachments?.length ?? 0,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            ctx.logger.error({ err: error }, 'Email send failed');
+            ctx.emitEvent?.completed?.(`❌ Failed to send email: ${errorMessage}`);
+            return {
+                success: false,
+                to: input.to,
+                subject: input.subject,
+                error: errorMessage,
+            };
+        }
+    }
+}
+//# sourceMappingURL=sendEmail.js.map

package/dist/core/tools/sendEmail.js.map

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

package/dist/core/tools/sendWebhook.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Send Webhook Tool
+ *
+ * Send a POST request with JSON payload to a webhook URL
+ */
+import { z } from 'zod';
+import { BaseTool, type ToolContext } from './base.js';
+declare const sendWebhookInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodAny>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    payload: Record<string, any>;
+    headers?: Record<string, string> | undefined;
+}, {
+    url: string;
+    payload: Record<string, any>;
+    headers?: Record<string, string> | undefined;
+}>;
+type SendWebhookInput = z.infer<typeof sendWebhookInputSchema>;
+interface SendWebhookOutput {
+    url: string;
+    status: number;
+    statusText: string;
+    success: boolean;
+    response?: any;
+}
+export declare class SendWebhookTool extends BaseTool<SendWebhookInput, SendWebhookOutput> {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        url: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodAny>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        payload: Record<string, any>;
+        headers?: Record<string, string> | undefined;
+    }, {
+        url: string;
+        payload: Record<string, any>;
+        headers?: Record<string, string> | undefined;
+    }>;
+    execute(input: SendWebhookInput, ctx: ToolContext): Promise<SendWebhookOutput>;
+}
+export {};
+//# sourceMappingURL=sendWebhook.d.ts.map

package/dist/core/tools/sendWebhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendWebhook.d.ts","sourceRoot":"","sources":["../../../src/core/tools/sendWebhook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvD,QAAA,MAAM,sBAAsB;;;;;;;;;;;;EAI1B,CAAC;AAEH,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/D,UAAU,iBAAiB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAChF,IAAI,SAAiB;IACrB,WAAW,SAA4D;IACvE,WAAW;;;;;;;;;;;;OAA0B;IAE/B,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAqDrF"}

package/dist/core/tools/sendWebhook.js

@@ -0,0 +1,61 @@
+/**
+ * Send Webhook Tool
+ *
+ * Send a POST request with JSON payload to a webhook URL
+ */
+import { z } from 'zod';
+import { BaseTool } from './base.js';
+const sendWebhookInputSchema = z.object({
+    url: z.string().url().describe('Webhook URL to send POST request to'),
+    payload: z.record(z.any()).describe('JSON payload to send'),
+    headers: z.record(z.string()).optional().describe('Optional custom headers'),
+});
+export class SendWebhookTool extends BaseTool {
+    name = 'sendWebhook';
+    description = 'Send a POST request with JSON payload to a webhook URL';
+    inputSchema = sendWebhookInputSchema;
+    async execute(input, ctx) {
+        ctx.logger.info(`Sending webhook to: ${input.url}`);
+        try {
+            const response = await this.retry(async () => {
+                return await this.withTimeout(fetch(input.url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'User-Agent': 'DesiAgent/1.0',
+                        ...input.headers,
+                    },
+                    body: JSON.stringify(input.payload),
+                    signal: ctx.abortSignal,
+                }), 10000, 'Webhook request timed out');
+            }, 3, 1000);
+            const success = response.ok;
+            let responseData;
+            try {
+                const contentType = response.headers.get('content-type');
+                if (contentType?.includes('application/json')) {
+                    responseData = await response.json();
+                }
+                else {
+                    responseData = await response.text();
+                }
+            }
+            catch {
+                responseData = null;
+            }
+            ctx.logger.info(`Webhook response: ${response.status} ${response.statusText}`);
+            return {
+                url: input.url,
+                status: response.status,
+                statusText: response.statusText,
+                success,
+                response: responseData,
+            };
+        }
+        catch (error) {
+            ctx.logger.error({ err: error }, 'Webhook send failed');
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=sendWebhook.js.map

package/dist/core/tools/sendWebhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendWebhook.js","sourceRoot":"","sources":["../../../src/core/tools/sendWebhook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAoB,MAAM,WAAW,CAAC;AAEvD,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACrE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAC7E,CAAC,CAAC;AAYH,MAAM,OAAO,eAAgB,SAAQ,QAA6C;IAChF,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG,wDAAwD,CAAC;IACvE,WAAW,GAAG,sBAAsB,CAAC;IAErC,KAAK,CAAC,OAAO,CAAC,KAAuB,EAAE,GAAgB;QACrD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAEpD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAC/B,KAAK,IAAI,EAAE;gBACT,OAAO,MAAM,IAAI,CAAC,WAAW,CAC3B,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE;oBACf,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,YAAY,EAAE,eAAe;wBAC7B,GAAG,KAAK,CAAC,OAAO;qBACjB;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;oBACnC,MAAM,EAAE,GAAG,CAAC,WAAW;iBACxB,CAAC,EACF,KAAK,EACL,2BAA2B,CAC5B,CAAC;YACJ,CAAC,EACD,CAAC,EACD,IAAI,CACL,CAAC;YAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC;YAC5B,IAAI,YAAiB,CAAC;YAEtB,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBACzD,IAAI,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC9C,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACvC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;YAED,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAE/E,OAAO;gBACL,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO;gBACP,QAAQ,EAAE,YAAY;aACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,qBAAqB,CAAC,CAAC;YACxD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/core/tools/webSearch.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Web Search Tool
+ *
+ * Searches the web using DuckDuckGo HTML search (no API key needed)
+ */
+import { z } from 'zod';
+import { BaseTool, type ToolContext } from './base.js';
+declare const webSearchInputSchema: z.ZodObject<{
+    query: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string | string[];
+    limit: number;
+}, {
+    query: string | string[];
+    limit?: number | undefined;
+}>;
+type WebSearchInput = z.infer<typeof webSearchInputSchema>;
+interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export declare class WebSearchTool extends BaseTool<any, SearchResult[]> {
+    name: string;
+    description: string;
+    inputSchema: any;
+    execute(input: WebSearchInput, ctx: ToolContext): Promise<SearchResult[]>;
+    private extractSearchQueries;
+    private parseSearchResults;
+    private cleanUrl;
+}
+export {};
+//# sourceMappingURL=webSearch.d.ts.map

package/dist/core/tools/webSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSearch.d.ts","sourceRoot":"","sources":["../../../src/core/tools/webSearch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvD,QAAA,MAAM,oBAAoB;;;;;;;;;EAGxB,CAAC;AAEH,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE3D,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAc,SAAQ,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC;IAC9D,IAAI,SAAe;IACnB,WAAW,SAAqD;IAChE,WAAW,EAAE,GAAG,CAAwB;IAElC,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAoC/E,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/core/tools/webSearch.js

@@ -0,0 +1,104 @@
+/**
+ * Web Search Tool
+ *
+ * Searches the web using DuckDuckGo HTML search (no API key needed)
+ */
+import { z } from 'zod';
+import * as cheerio from 'cheerio';
+import { BaseTool } from './base.js';
+const webSearchInputSchema = z.object({
+    query: z.union([z.string(), z.array(z.string())]).describe('The search query - string or array of strings'),
+    limit: z.number().int().min(1).max(20).default(10).describe('Number of results to return per query'),
+});
+export class WebSearchTool extends BaseTool {
+    name = 'webSearch';
+    description = 'Search the web for information using DuckDuckGo';
+    inputSchema = webSearchInputSchema;
+    async execute(input, ctx) {
+        const queryString = Array.isArray(input.query) ? input.query.join('\n') : input.query;
+        ctx.logger.info(`╰─Searching web...input for ${queryString.slice(0, 50)}...`);
+        ctx.emitEvent?.progress?.(`🔎 for ${queryString.slice(0, 50)}...`);
+        const queries = this.extractSearchQueries(queryString);
+        const allResults = [];
+        for (const query of queries) {
+            try {
+                const response = await this.withTimeout(fetch(`https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`), 10000, 'Web search timed out');
+                if (!response.ok) {
+                    throw new Error(`Search failed with status ${response.status}`);
+                }
+                const html = await response.text();
+                const results = this.parseSearchResults(html, input.limit);
+                ctx.logger.info(`  ╰─Found ${results.length} search results for query: ${query.slice(0, 50)}...`);
+                allResults.push(results);
+            }
+            catch (error) {
+                ctx.logger.error({ err: error, query }, '  ╰─Web search failed');
+                throw error;
+            }
+        }
+        ctx.emitEvent?.progress?.(`🔎 Found ${allResults.flat().length} results`);
+        return allResults.flat();
+    }
+    extractSearchQueries(text) {
+        const lines = text.trim().split('\n');
+        const queries = lines
+            .map((line) => {
+            let cleaned = line
+                .trim()
+                .replace(/^(\d+\.|\*\s*|\-\s*|•\s*)/, '')
+                .trim();
+            const match = cleaned.match(/"([^"]*)"/);
+            if (match) {
+                return match[1];
+            }
+            return cleaned;
+        })
+            .filter((query) => query.length > 0);
+        return queries;
+    }
+    parseSearchResults(html, limit) {
+        const results = [];
+        try {
+            const $ = cheerio.load(html);
+            $('.result').each((_, element) => {
+                if (results.length >= limit)
+                    return;
+                const titleLink = $(element).find('.result__a');
+                const snippetElem = $(element).find('.result__snippet');
+                const href = titleLink.attr('href');
+                const title = titleLink.text().trim();
+                const snippet = snippetElem.text().trim();
+                if (href && title) {
+                    const url = this.cleanUrl(href);
+                    if (url) {
+                        results.push({ title, url, snippet });
+                    }
+                }
+            });
+        }
+        catch (error) {
+            // If parsing fails, return fallback
+        }
+        if (results.length === 0) {
+            return [{
+                    title: 'Search results unavailable',
+                    url: 'https://duckduckgo.com',
+                    snippet: 'Web search completed but parsing failed. Consider using a different search method.',
+                }];
+        }
+        return results;
+    }
+    cleanUrl(url) {
+        const match = url.match(/uddg=([^&]+)/);
+        if (match) {
+            try {
+                return decodeURIComponent(match[1]);
+            }
+            catch {
+                return '';
+            }
+        }
+        return url;
+    }
+}
+//# sourceMappingURL=webSearch.js.map

package/dist/core/tools/webSearch.js.map

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

package/dist/core/tools/writeFile.d.ts

@@ -0,0 +1,49 @@
+/**
+ * WriteFileTool
+ *
+ * Writes content to files with overwrite and append modes.
+ * Uses bun's fs API.
+ */
+import { z } from 'zod';
+import { BaseTool, type ToolContext } from './base.js';
+declare const writeFileInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+    mode: z.ZodDefault<z.ZodEnum<["overwrite", "append"]>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    content: string;
+    mode: "overwrite" | "append";
+}, {
+    path: string;
+    content: string;
+    mode?: "overwrite" | "append" | undefined;
+}>;
+type WriteFileInput = z.infer<typeof writeFileInputSchema>;
+interface WriteFileOutput {
+    path: string;
+    fullPath: string;
+    bytesWritten: number;
+    mode: 'overwrite' | 'append';
+}
+/**
+ * WriteFileTool for bun
+ * Uses bun's fs API which is compatible with Node.js fs/promises
+ */
+export declare class WriteFileTool extends BaseTool<any, WriteFileOutput> {
+    name: string;
+    description: string;
+    inputSchema: any;
+    private logger;
+    private getArtifactsDir;
+    /**
+     * Strip outermost code fence from markdown
+     */
+    private stripOutermostFences;
+    /**
+     * Execute file write operation
+     */
+    execute(input: WriteFileInput, ctx: ToolContext): Promise<WriteFileOutput>;
+}
+export {};
+//# sourceMappingURL=writeFile.d.ts.map

package/dist/core/tools/writeFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFile.d.ts","sourceRoot":"","sources":["../../../src/core/tools/writeFile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAMvD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;EAOxB,CAAC;AAEH,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE3D,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC/D,IAAI,SAAe;IACnB,WAAW,SAAwD;IACnE,WAAW,EAAE,GAAG,CAAwB;IAExC,OAAO,CAAC,MAAM,CAAe;IAE7B,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+C5B;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,eAAe,CAAC;CAyD5B"}

package/dist/core/tools/writeFile.js

@@ -0,0 +1,120 @@
+/**
+ * WriteFileTool
+ *
+ * Writes content to files with overwrite and append modes.
+ * Uses bun's fs API.
+ */
+import { z } from 'zod';
+import { BaseTool } from './base.js';
+import { writeFile, mkdir, readFile } from 'fs/promises';
+import { dirname, resolve } from 'path';
+import { existsSync } from 'fs';
+import { getLogger } from '../../util/logger.js';
+const writeFileInputSchema = z.object({
+    path: z.string().describe('File path relative to artifacts directory'),
+    content: z.string().describe('Content to write to the file'),
+    mode: z
+        .enum(['overwrite', 'append'])
+        .default('overwrite')
+        .describe('Write mode'),
+});
+/**
+ * WriteFileTool for bun
+ * Uses bun's fs API which is compatible with Node.js fs/promises
+ */
+export class WriteFileTool extends BaseTool {
+    name = 'writeFile';
+    description = 'Write content to a file in the artifacts directory';
+    inputSchema = writeFileInputSchema;
+    logger = getLogger();
+    getArtifactsDir(ctx) {
+        return resolve(ctx.artifactsDir || process.env.ARTIFACTS_DIR || './artifacts');
+    }
+    /**
+     * Strip outermost code fence from markdown
+     */
+    stripOutermostFences(markdown) {
+        if (typeof markdown !== 'string') {
+            return markdown;
+        }
+        const trimmed = markdown.trim();
+        if (trimmed.length === 0) {
+            return '';
+        }
+        // Regex to match a fence line: 3+ backticks or tildes
+        const fenceRegex = /^([ \t]*)([`~]{3,})[^`\n~]*$/;
+        const lines = trimmed.split('\n');
+        // Check the first line for opening fence
+        const firstLineMatch = lines[0].match(fenceRegex);
+        if (!firstLineMatch) {
+            return markdown;
+        }
+        const openingFenceChar = firstLineMatch[2][0];
+        const openingFenceLength = firstLineMatch[2].length;
+        // Find the closing fence
+        let closingIndex = -1;
+        for (let i = lines.length - 1; i > 0; i--) {
+            const match = lines[i].match(fenceRegex);
+            if (match &&
+                match[2][0] === openingFenceChar &&
+                match[2].length >= openingFenceLength) {
+                closingIndex = i;
+                break;
+            }
+        }
+        if (closingIndex === -1) {
+            return markdown;
+        }
+        // Extract content between fences
+        const contentLines = lines.slice(1, closingIndex);
+        return contentLines.join('\n');
+    }
+    /**
+     * Execute file write operation
+     */
+    async execute(input, ctx) {
+        const ARTIFACTS_DIR = this.getArtifactsDir(ctx);
+        // Security: prevent path traversal
+        const fullPath = resolve(ARTIFACTS_DIR, input.path);
+        // Ensure path is within artifacts directory
+        if (!fullPath.startsWith(ARTIFACTS_DIR)) {
+            throw new Error('Invalid path: must be within artifacts directory');
+        }
+        const safePath = fullPath.substring(ARTIFACTS_DIR.length + 1);
+        //this.logger.info(`Writing file: ${safePath}`);
+        try {
+            // Ensure directory exists
+            const dir = dirname(fullPath);
+            if (!existsSync(dir)) {
+                await mkdir(dir, { recursive: true });
+            }
+            // Write or append content
+            let finalContent = this.stripOutermostFences(input.content);
+            if (input.mode === 'append' && existsSync(fullPath)) {
+                const existing = await readFile(fullPath, 'utf-8');
+                finalContent = existing + finalContent;
+            }
+            await writeFile(fullPath, finalContent, 'utf-8');
+            const bytesWritten = Buffer.byteLength(input.content, 'utf-8');
+            //this.logger.info(`Wrote ${bytesWritten} bytes to ${safePath}`);
+            if (ctx.onEvent) {
+                ctx.onEvent('tool:writeFile:completed', {
+                    path: safePath,
+                    bytesWritten,
+                    mode: input.mode,
+                });
+            }
+            return {
+                path: safePath,
+                fullPath,
+                bytesWritten,
+                mode: input.mode,
+            };
+        }
+        catch (error) {
+            this.logger.error(`File write failed: ${error instanceof Error ? error.message : String(error)}`);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=writeFile.js.map

package/dist/core/tools/writeFile.js.map

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

package/dist/db/client.d.ts

@@ -0,0 +1,22 @@
+import * as schema from './schema.js';
+import type { BunSQLiteDatabase } from 'drizzle-orm/bun-sqlite';
+export type DrizzleDB = BunSQLiteDatabase<typeof schema>;
+/**
+ * Get or create the global database instance
+ */
+export declare function getDatabase(dbPath: string): DrizzleDB;
+/**
+ * Close database connection
+ */
+export declare function closeDatabase(): void;
+/**
+ * Run database migrations
+ * Note: For Phase 2, this is a placeholder.
+ * In production, migrations should be managed via drizzle-kit
+ */
+export declare function runMigrations(db: DrizzleDB): Promise<void>;
+/**
+ * Execute a query with error handling
+ */
+export declare function withDatabase<T>(db: DrizzleDB, operation: (db: DrizzleDB) => Promise<T>): Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/dist/db/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAItC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,MAAM,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,MAAM,CAAC,CAAC;AAqIzD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAKrD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAapC;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,EAAE,EAAE,SAAS,EACb,SAAS,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC,CAYZ"}