workflowskill 0.1.0

package/dist/gmail-CYBJ6Dxa.mjs

@@ -0,0 +1,209 @@
+import { gmail } from "@googleapis/gmail";
+
+//#region src/dev-tools/tools/gmail.ts
+const searchDescriptor = {
+	name: "gmail.search",
+	description: "Search Gmail messages matching a query.",
+	inputSchema: {
+		type: "object",
+		properties: {
+			query: {
+				type: "string",
+				description: "Gmail search query (same syntax as Gmail search bar)"
+			},
+			max_results: {
+				type: "number",
+				description: "Maximum messages to return (default: 10)"
+			}
+		},
+		required: ["query"]
+	},
+	outputSchema: {
+		type: "object",
+		properties: { messages: {
+			type: "array",
+			items: {
+				type: "object",
+				properties: {
+					id: { type: "string" },
+					from: { type: "string" },
+					to: { type: "string" },
+					subject: { type: "string" },
+					snippet: { type: "string" },
+					date: { type: "string" }
+				}
+			}
+		} }
+	}
+};
+const readDescriptor = {
+	name: "gmail.read",
+	description: "Read a full Gmail message by ID.",
+	inputSchema: {
+		type: "object",
+		properties: { message_id: {
+			type: "string",
+			description: "Gmail message ID"
+		} },
+		required: ["message_id"]
+	},
+	outputSchema: {
+		type: "object",
+		properties: {
+			id: { type: "string" },
+			from: { type: "string" },
+			to: { type: "string" },
+			subject: { type: "string" },
+			body: { type: "string" },
+			date: { type: "string" }
+		}
+	}
+};
+const sendDescriptor = {
+	name: "gmail.send",
+	description: "Send an email via Gmail.",
+	inputSchema: {
+		type: "object",
+		properties: {
+			to: {
+				type: "string",
+				description: "Recipient email address"
+			},
+			subject: {
+				type: "string",
+				description: "Email subject"
+			},
+			body: {
+				type: "string",
+				description: "Email body (plain text)"
+			}
+		},
+		required: [
+			"to",
+			"subject",
+			"body"
+		]
+	},
+	outputSchema: {
+		type: "object",
+		properties: { message_id: { type: "string" } }
+	}
+};
+function getHeader(headers, name) {
+	return headers?.find((h) => h.name?.toLowerCase() === name.toLowerCase())?.value ?? "";
+}
+function decodeBody(message) {
+	const parts = message.payload?.parts;
+	if (parts) {
+		const textPart = parts.find((p) => p.mimeType === "text/plain");
+		if (textPart?.body?.data) return Buffer.from(textPart.body.data, "base64url").toString("utf-8");
+	}
+	if (message.payload?.body?.data) return Buffer.from(message.payload.body.data, "base64url").toString("utf-8");
+	return message.snippet ?? "";
+}
+function createHandlers(auth) {
+	const client = gmail({
+		version: "v1",
+		auth
+	});
+	async function search(args) {
+		const query = args.query;
+		const maxResults = args.max_results ?? 10;
+		if (!query || typeof query !== "string") return {
+			output: null,
+			error: "gmail.search: \"query\" is required"
+		};
+		try {
+			const messageIds = (await client.users.messages.list({
+				userId: "me",
+				q: query,
+				maxResults
+			})).data.messages ?? [];
+			return { output: { messages: await Promise.all(messageIds.map(async (m) => {
+				const msg = await client.users.messages.get({
+					userId: "me",
+					id: m.id,
+					format: "metadata",
+					metadataHeaders: [
+						"From",
+						"To",
+						"Subject",
+						"Date"
+					]
+				});
+				const headers = msg.data.payload?.headers;
+				return {
+					id: msg.data.id ?? "",
+					from: getHeader(headers, "From"),
+					to: getHeader(headers, "To"),
+					subject: getHeader(headers, "Subject"),
+					snippet: msg.data.snippet ?? "",
+					date: getHeader(headers, "Date")
+				};
+			})) } };
+		} catch (err) {
+			return {
+				output: null,
+				error: `gmail.search failed: ${err instanceof Error ? err.message : String(err)}`
+			};
+		}
+	}
+	async function read(args) {
+		const messageId = args.message_id;
+		if (!messageId || typeof messageId !== "string") return {
+			output: null,
+			error: "gmail.read: \"message_id\" is required"
+		};
+		try {
+			const msg = await client.users.messages.get({
+				userId: "me",
+				id: messageId,
+				format: "full"
+			});
+			const headers = msg.data.payload?.headers;
+			return { output: {
+				id: msg.data.id ?? "",
+				from: getHeader(headers, "From"),
+				to: getHeader(headers, "To"),
+				subject: getHeader(headers, "Subject"),
+				body: decodeBody(msg.data),
+				date: getHeader(headers, "Date")
+			} };
+		} catch (err) {
+			return {
+				output: null,
+				error: `gmail.read failed: ${err instanceof Error ? err.message : String(err)}`
+			};
+		}
+	}
+	async function send(args) {
+		const to = args.to;
+		const subject = args.subject;
+		const body = args.body;
+		if (!to || !subject || !body) return {
+			output: null,
+			error: "gmail.send: \"to\", \"subject\", and \"body\" are required"
+		};
+		try {
+			const raw = Buffer.from(`To: ${to}\r\nSubject: ${subject}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n${body}`).toString("base64url");
+			return { output: { message_id: (await client.users.messages.send({
+				userId: "me",
+				requestBody: { raw }
+			})).data.id ?? "" } };
+		} catch (err) {
+			return {
+				output: null,
+				error: `gmail.send failed: ${err instanceof Error ? err.message : String(err)}`
+			};
+		}
+	}
+	return {
+		search,
+		read,
+		send
+	};
+}
+
+//#endregion
+export { createHandlers, readDescriptor, searchDescriptor, sendDescriptor };
+//# sourceMappingURL=gmail-CYBJ6Dxa.mjs.map

package/dist/gmail-CYBJ6Dxa.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-CYBJ6Dxa.mjs","names":[],"sources":["../src/dev-tools/tools/gmail.ts"],"sourcesContent":["// Tools: gmail.search, gmail.read, gmail.send — Gmail integration via googleapis.\n\nimport { gmail, gmail_v1 } from '@googleapis/gmail';\nimport type { OAuth2Client } from 'google-auth-library';\nimport type { ToolDescriptor, ToolResult } from '../../types/index.js';\n\n// ─── Tool descriptors ────────────────────────────────────────────────────────\n\nexport const searchDescriptor: ToolDescriptor = {\n  name: 'gmail.search',\n  description: 'Search Gmail messages matching a query.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      query: { type: 'string', description: 'Gmail search query (same syntax as Gmail search bar)' },\n      max_results: { type: 'number', description: 'Maximum messages to return (default: 10)' },\n    },\n    required: ['query'],\n  },\n  outputSchema: {\n    type: 'object',\n    properties: {\n      messages: {\n        type: 'array',\n        items: {\n          type: 'object',\n          properties: {\n            id: { type: 'string' },\n            from: { type: 'string' },\n            to: { type: 'string' },\n            subject: { type: 'string' },\n            snippet: { type: 'string' },\n            date: { type: 'string' },\n          },\n        },\n      },\n    },\n  },\n};\n\nexport const readDescriptor: ToolDescriptor = {\n  name: 'gmail.read',\n  description: 'Read a full Gmail message by ID.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      message_id: { type: 'string', description: 'Gmail message ID' },\n    },\n    required: ['message_id'],\n  },\n  outputSchema: {\n    type: 'object',\n    properties: {\n      id: { type: 'string' },\n      from: { type: 'string' },\n      to: { type: 'string' },\n      subject: { type: 'string' },\n      body: { type: 'string' },\n      date: { type: 'string' },\n    },\n  },\n};\n\nexport const sendDescriptor: ToolDescriptor = {\n  name: 'gmail.send',\n  description: 'Send an email via Gmail.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      to: { type: 'string', description: 'Recipient email address' },\n      subject: { type: 'string', description: 'Email subject' },\n      body: { type: 'string', description: 'Email body (plain text)' },\n    },\n    required: ['to', 'subject', 'body'],\n  },\n  outputSchema: {\n    type: 'object',\n    properties: {\n      message_id: { type: 'string' },\n    },\n  },\n};\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nfunction getHeader(\n  headers: gmail_v1.Schema$MessagePartHeader[] | undefined,\n  name: string,\n): string {\n  return headers?.find((h) => h.name?.toLowerCase() === name.toLowerCase())?.value ?? '';\n}\n\nfunction decodeBody(message: gmail_v1.Schema$Message): string {\n  // Try to get plain text body from parts\n  const parts = message.payload?.parts;\n  if (parts) {\n    const textPart = parts.find((p) => p.mimeType === 'text/plain');\n    if (textPart?.body?.data) {\n      return Buffer.from(textPart.body.data, 'base64url').toString('utf-8');\n    }\n  }\n  // Fallback to payload body\n  if (message.payload?.body?.data) {\n    return Buffer.from(message.payload.body.data, 'base64url').toString('utf-8');\n  }\n  return message.snippet ?? '';\n}\n\n// ─── Handlers ────────────────────────────────────────────────────────────────\n\nexport function createHandlers(auth: OAuth2Client) {\n  const client = gmail({ version: 'v1', auth });\n\n  async function search(args: Record<string, unknown>): Promise<ToolResult> {\n    const query = args.query as string | undefined;\n    const maxResults = (args.max_results as number | undefined) ?? 10;\n\n    if (!query || typeof query !== 'string') {\n      return { output: null, error: 'gmail.search: \"query\" is required' };\n    }\n\n    try {\n      const listRes = await client.users.messages.list({\n        userId: 'me',\n        q: query,\n        maxResults,\n      });\n\n      const messageIds = listRes.data.messages ?? [];\n      const messages = await Promise.all(\n        messageIds.map(async (m: gmail_v1.Schema$Message) => {\n          const msg = await client.users.messages.get({\n            userId: 'me',\n            id: m.id!,\n            format: 'metadata',\n            metadataHeaders: ['From', 'To', 'Subject', 'Date'],\n          });\n          const headers = msg.data.payload?.headers;\n          return {\n            id: msg.data.id ?? '',\n            from: getHeader(headers, 'From'),\n            to: getHeader(headers, 'To'),\n            subject: getHeader(headers, 'Subject'),\n            snippet: msg.data.snippet ?? '',\n            date: getHeader(headers, 'Date'),\n          };\n        }),\n      );\n\n      return { output: { messages } };\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      return { output: null, error: `gmail.search failed: ${message}` };\n    }\n  }\n\n  async function read(args: Record<string, unknown>): Promise<ToolResult> {\n    const messageId = args.message_id as string | undefined;\n\n    if (!messageId || typeof messageId !== 'string') {\n      return { output: null, error: 'gmail.read: \"message_id\" is required' };\n    }\n\n    try {\n      const msg = await client.users.messages.get({\n        userId: 'me',\n        id: messageId,\n        format: 'full',\n      });\n\n      const headers = msg.data.payload?.headers;\n      return {\n        output: {\n          id: msg.data.id ?? '',\n          from: getHeader(headers, 'From'),\n          to: getHeader(headers, 'To'),\n          subject: getHeader(headers, 'Subject'),\n          body: decodeBody(msg.data),\n          date: getHeader(headers, 'Date'),\n        },\n      };\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      return { output: null, error: `gmail.read failed: ${message}` };\n    }\n  }\n\n  async function send(args: Record<string, unknown>): Promise<ToolResult> {\n    const to = args.to as string | undefined;\n    const subject = args.subject as string | undefined;\n    const body = args.body as string | undefined;\n\n    if (!to || !subject || !body) {\n      return { output: null, error: 'gmail.send: \"to\", \"subject\", and \"body\" are required' };\n    }\n\n    try {\n      const raw = Buffer.from(\n        `To: ${to}\\r\\nSubject: ${subject}\\r\\nContent-Type: text/plain; charset=utf-8\\r\\n\\r\\n${body}`,\n      ).toString('base64url');\n\n      const res = await client.users.messages.send({\n        userId: 'me',\n        requestBody: { raw },\n      });\n\n      return { output: { message_id: res.data.id ?? '' } };\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      return { output: null, error: `gmail.send failed: ${message}` };\n    }\n  }\n\n  return { search, read, send };\n}\n"],"mappings":"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"}

package/dist/html-select-BZPYAr6k.mjs

@@ -0,0 +1,104 @@
+import * as cheerio from "cheerio";
+
+//#region src/dev-tools/tools/html-select.ts
+const descriptor = {
+	name: "html.select",
+	description: "Extract data from HTML using CSS selectors. Returns text content, attribute values, or structured objects.",
+	inputSchema: {
+		type: "object",
+		properties: {
+			html: {
+				type: "string",
+				description: "HTML content to search"
+			},
+			selector: {
+				type: "string",
+				description: "CSS selector to match elements"
+			},
+			attribute: {
+				type: "string",
+				description: "Attribute to extract instead of text content (ignored when fields is present)"
+			},
+			limit: {
+				type: "number",
+				description: "Maximum number of results to return"
+			},
+			fields: {
+				type: "object",
+				description: "Map of field names to sub-selectors for structured extraction. Each value is a CSS selector scoped to the matched parent. Append \" @attr\" to extract an attribute (e.g. \"a @href\", \"img @src\"). Bare \"@attr\" extracts from the parent itself. When present, returns array of objects instead of strings."
+			}
+		},
+		required: ["html", "selector"]
+	},
+	outputSchema: {
+		type: "object",
+		properties: { results: {
+			type: "array",
+			description: "Extracted values: strings without fields, objects with fields"
+		} }
+	}
+};
+/**
+* Parse a field spec string into a sub-selector and optional attribute name.
+* Formats: "h3.title" → text, "a.link @href" → attribute, "@data-id" → parent attribute.
+*/
+function parseFieldSpec(spec) {
+	const atIndex = spec.lastIndexOf(" @");
+	if (atIndex >= 0) return {
+		subSelector: spec.slice(0, atIndex).trim() || null,
+		attr: spec.slice(atIndex + 2).trim() || null
+	};
+	if (spec.startsWith("@")) return {
+		subSelector: null,
+		attr: spec.slice(1)
+	};
+	return {
+		subSelector: spec,
+		attr: null
+	};
+}
+async function handler(args) {
+	const { html, selector, attribute, limit, fields } = args;
+	if (!html || typeof html !== "string") return {
+		output: null,
+		error: "html.select: \"html\" is required and must be a string"
+	};
+	if (!selector || typeof selector !== "string") return {
+		output: null,
+		error: "html.select: \"selector\" is required and must be a string"
+	};
+	const $ = cheerio.load(html);
+	const elements = $(selector);
+	if (fields && typeof fields === "object") {
+		const parsedFields = Object.entries(fields).map(([name, spec]) => ({
+			name,
+			...parseFieldSpec(spec)
+		}));
+		let results = [];
+		elements.each((_i, el) => {
+			const row = {};
+			for (const { name, subSelector, attr } of parsedFields) {
+				const target = subSelector ? $(el).find(subSelector).first() : $(el);
+				if (target.length === 0) row[name] = null;
+				else if (attr) row[name] = target.attr(attr) ?? null;
+				else row[name] = target.text().trim();
+			}
+			results.push(row);
+		});
+		if (limit !== void 0 && limit > 0) results = results.slice(0, limit);
+		return { output: { results } };
+	}
+	let results = [];
+	elements.each((_i, el) => {
+		if (attribute) {
+			const val = $(el).attr(attribute);
+			if (val !== void 0) results.push(val);
+		} else results.push($(el).text().trim());
+	});
+	if (limit !== void 0 && limit > 0) results = results.slice(0, limit);
+	return { output: { results } };
+}
+
+//#endregion
+export { descriptor, handler };
+//# sourceMappingURL=html-select-BZPYAr6k.mjs.map

package/dist/html-select-BZPYAr6k.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-select-BZPYAr6k.mjs","names":[],"sources":["../src/dev-tools/tools/html-select.ts"],"sourcesContent":["// Tool: html.select — extract data from HTML using CSS selectors.\n\nimport * as cheerio from 'cheerio';\nimport type { ToolDescriptor, ToolResult } from '../../types/index.js';\n\nexport interface HtmlSelectArgs {\n  html: string;\n  selector: string;\n  attribute?: string;\n  limit?: number;\n  fields?: Record<string, string>;\n}\n\nexport const descriptor: ToolDescriptor = {\n  name: 'html.select',\n  description:\n    'Extract data from HTML using CSS selectors. Returns text content, attribute values, or structured objects.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      html: { type: 'string', description: 'HTML content to search' },\n      selector: { type: 'string', description: 'CSS selector to match elements' },\n      attribute: {\n        type: 'string',\n        description: 'Attribute to extract instead of text content (ignored when fields is present)',\n      },\n      limit: { type: 'number', description: 'Maximum number of results to return' },\n      fields: {\n        type: 'object',\n        description:\n          'Map of field names to sub-selectors for structured extraction. Each value is a CSS selector scoped to the matched parent. Append \" @attr\" to extract an attribute (e.g. \"a @href\", \"img @src\"). Bare \"@attr\" extracts from the parent itself. When present, returns array of objects instead of strings.',\n      },\n    },\n    required: ['html', 'selector'],\n  },\n  outputSchema: {\n    type: 'object',\n    properties: {\n      results: {\n        type: 'array',\n        description: 'Extracted values: strings without fields, objects with fields',\n      },\n    },\n  },\n};\n\n/**\n * Parse a field spec string into a sub-selector and optional attribute name.\n * Formats: \"h3.title\" → text, \"a.link @href\" → attribute, \"@data-id\" → parent attribute.\n */\nfunction parseFieldSpec(spec: string): { subSelector: string | null; attr: string | null } {\n  const atIndex = spec.lastIndexOf(' @');\n  if (atIndex >= 0) {\n    // \"sub-selector @attr\"\n    const subSelector = spec.slice(0, atIndex).trim() || null;\n    const attr = spec.slice(atIndex + 2).trim();\n    return { subSelector, attr: attr || null };\n  }\n  if (spec.startsWith('@')) {\n    // Bare \"@attr\" — extract attribute from parent\n    return { subSelector: null, attr: spec.slice(1) };\n  }\n  // Plain sub-selector — extract text\n  return { subSelector: spec, attr: null };\n}\n\nexport async function handler(args: Record<string, unknown>): Promise<ToolResult> {\n  const { html, selector, attribute, limit, fields } = args as unknown as HtmlSelectArgs;\n\n  if (!html || typeof html !== 'string') {\n    return { output: null, error: 'html.select: \"html\" is required and must be a string' };\n  }\n  if (!selector || typeof selector !== 'string') {\n    return { output: null, error: 'html.select: \"selector\" is required and must be a string' };\n  }\n\n  const $ = cheerio.load(html);\n  const elements = $(selector);\n\n  if (fields && typeof fields === 'object') {\n    // Structured extraction: return array of objects\n    const parsedFields = Object.entries(fields).map(([name, spec]) => ({\n      name,\n      ...parseFieldSpec(spec),\n    }));\n\n    let results: Array<Record<string, string | null>> = [];\n    elements.each((_i, el) => {\n      const row: Record<string, string | null> = {};\n      for (const { name, subSelector, attr } of parsedFields) {\n        const target = subSelector ? $(el).find(subSelector).first() : $(el);\n        if (target.length === 0) {\n          row[name] = null;\n        } else if (attr) {\n          row[name] = target.attr(attr) ?? null;\n        } else {\n          row[name] = target.text().trim();\n        }\n      }\n      results.push(row);\n    });\n\n    if (limit !== undefined && limit > 0) {\n      results = results.slice(0, limit);\n    }\n\n    return { output: { results } };\n  }\n\n  // Simple extraction: return array of strings (original behavior)\n  let results: string[] = [];\n  elements.each((_i, el) => {\n    if (attribute) {\n      const val = $(el).attr(attribute);\n      if (val !== undefined) {\n        results.push(val);\n      }\n    } else {\n      results.push($(el).text().trim());\n    }\n  });\n\n  if (limit !== undefined && limit > 0) {\n    results = results.slice(0, limit);\n  }\n\n  return { output: { results } };\n}\n"],"mappings":";;;AAaA,MAAa,aAA6B;CACxC,MAAM;CACN,aACE;CACF,aAAa;EACX,MAAM;EACN,YAAY;GACV,MAAM;IAAE,MAAM;IAAU,aAAa;IAA0B;GAC/D,UAAU;IAAE,MAAM;IAAU,aAAa;IAAkC;GAC3E,WAAW;IACT,MAAM;IACN,aAAa;IACd;GACD,OAAO;IAAE,MAAM;IAAU,aAAa;IAAuC;GAC7E,QAAQ;IACN,MAAM;IACN,aACE;IACH;GACF;EACD,UAAU,CAAC,QAAQ,WAAW;EAC/B;CACD,cAAc;EACZ,MAAM;EACN,YAAY,EACV,SAAS;GACP,MAAM;GACN,aAAa;GACd,EACF;EACF;CACF;;;;;AAMD,SAAS,eAAe,MAAmE;CACzF,MAAM,UAAU,KAAK,YAAY,KAAK;AACtC,KAAI,WAAW,EAIb,QAAO;EAAE,aAFW,KAAK,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI;EAE/B,MADT,KAAK,MAAM,UAAU,EAAE,CAAC,MAAM,IACP;EAAM;AAE5C,KAAI,KAAK,WAAW,IAAI,CAEtB,QAAO;EAAE,aAAa;EAAM,MAAM,KAAK,MAAM,EAAE;EAAE;AAGnD,QAAO;EAAE,aAAa;EAAM,MAAM;EAAM;;AAG1C,eAAsB,QAAQ,MAAoD;CAChF,MAAM,EAAE,MAAM,UAAU,WAAW,OAAO,WAAW;AAErD,KAAI,CAAC,QAAQ,OAAO,SAAS,SAC3B,QAAO;EAAE,QAAQ;EAAM,OAAO;EAAwD;AAExF,KAAI,CAAC,YAAY,OAAO,aAAa,SACnC,QAAO;EAAE,QAAQ;EAAM,OAAO;EAA4D;CAG5F,MAAM,IAAI,QAAQ,KAAK,KAAK;CAC5B,MAAM,WAAW,EAAE,SAAS;AAE5B,KAAI,UAAU,OAAO,WAAW,UAAU;EAExC,MAAM,eAAe,OAAO,QAAQ,OAAO,CAAC,KAAK,CAAC,MAAM,WAAW;GACjE;GACA,GAAG,eAAe,KAAK;GACxB,EAAE;EAEH,IAAI,UAAgD,EAAE;AACtD,WAAS,MAAM,IAAI,OAAO;GACxB,MAAM,MAAqC,EAAE;AAC7C,QAAK,MAAM,EAAE,MAAM,aAAa,UAAU,cAAc;IACtD,MAAM,SAAS,cAAc,EAAE,GAAG,CAAC,KAAK,YAAY,CAAC,OAAO,GAAG,EAAE,GAAG;AACpE,QAAI,OAAO,WAAW,EACpB,KAAI,QAAQ;aACH,KACT,KAAI,QAAQ,OAAO,KAAK,KAAK,IAAI;QAEjC,KAAI,QAAQ,OAAO,MAAM,CAAC,MAAM;;AAGpC,WAAQ,KAAK,IAAI;IACjB;AAEF,MAAI,UAAU,UAAa,QAAQ,EACjC,WAAU,QAAQ,MAAM,GAAG,MAAM;AAGnC,SAAO,EAAE,QAAQ,EAAE,SAAS,EAAE;;CAIhC,IAAI,UAAoB,EAAE;AAC1B,UAAS,MAAM,IAAI,OAAO;AACxB,MAAI,WAAW;GACb,MAAM,MAAM,EAAE,GAAG,CAAC,KAAK,UAAU;AACjC,OAAI,QAAQ,OACV,SAAQ,KAAK,IAAI;QAGnB,SAAQ,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;GAEnC;AAEF,KAAI,UAAU,UAAa,QAAQ,EACjC,WAAU,QAAQ,MAAM,GAAG,MAAM;AAGnC,QAAO,EAAE,QAAQ,EAAE,SAAS,EAAE"}

package/dist/http-request-k9bp5joL.mjs

@@ -0,0 +1,91 @@
+//#region src/dev-tools/tools/http-request.ts
+const descriptor = {
+	name: "http.request",
+	description: "Make an HTTP request and return the response status, headers, and body.",
+	inputSchema: {
+		type: "object",
+		properties: {
+			url: {
+				type: "string",
+				description: "The URL to request"
+			},
+			method: {
+				type: "string",
+				description: "HTTP method (default: GET)"
+			},
+			headers: {
+				type: "object",
+				description: "Request headers as key-value pairs"
+			},
+			body: {
+				type: "string",
+				description: "Request body (for POST/PUT/PATCH)"
+			},
+			timeout: {
+				type: "number",
+				description: "Request timeout in milliseconds (default: 30000)"
+			}
+		},
+		required: ["url"]
+	},
+	outputSchema: {
+		type: "object",
+		properties: {
+			status: {
+				type: "number",
+				description: "HTTP status code"
+			},
+			headers: {
+				type: "object",
+				description: "Response headers"
+			},
+			body: {
+				type: "object",
+				description: "Response body — parsed object when content-type is application/json, raw string otherwise"
+			}
+		}
+	}
+};
+async function handler(args) {
+	const { url, method, headers, body: requestBody, timeout } = args;
+	if (!url || typeof url !== "string") return {
+		output: null,
+		error: "http.request: \"url\" is required and must be a string"
+	};
+	try {
+		const controller = new AbortController();
+		const timeoutMs = timeout ?? 3e4;
+		const timer = setTimeout(() => controller.abort(), timeoutMs);
+		const response = await fetch(url, {
+			method: method ?? "GET",
+			headers,
+			body: requestBody,
+			signal: controller.signal
+		});
+		clearTimeout(timer);
+		const responseText = await response.text();
+		const responseHeaders = {};
+		response.headers.forEach((value, key) => {
+			responseHeaders[key] = value;
+		});
+		const contentType = response.headers.get("content-type") ?? "";
+		let responseBody = responseText;
+		if (contentType.includes("application/json")) try {
+			responseBody = JSON.parse(responseText);
+		} catch {}
+		return { output: {
+			status: response.status,
+			headers: responseHeaders,
+			body: responseBody
+		} };
+	} catch (err) {
+		return {
+			output: null,
+			error: `http.request failed: ${err instanceof Error ? err.message : String(err)}`
+		};
+	}
+}
+
+//#endregion
+export { descriptor, handler };
+//# sourceMappingURL=http-request-k9bp5joL.mjs.map

package/dist/http-request-k9bp5joL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-request-k9bp5joL.mjs","names":[],"sources":["../src/dev-tools/tools/http-request.ts"],"sourcesContent":["// Tool: http.request — make HTTP requests using Node built-in fetch.\n\nimport type { ToolDescriptor, ToolResult } from '../../types/index.js';\n\nexport interface HttpRequestArgs {\n  url: string;\n  method?: string;\n  headers?: Record<string, string>;\n  body?: string;\n  timeout?: number;\n}\n\nexport const descriptor: ToolDescriptor = {\n  name: 'http.request',\n  description: 'Make an HTTP request and return the response status, headers, and body.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      url: { type: 'string', description: 'The URL to request' },\n      method: { type: 'string', description: 'HTTP method (default: GET)' },\n      headers: { type: 'object', description: 'Request headers as key-value pairs' },\n      body: { type: 'string', description: 'Request body (for POST/PUT/PATCH)' },\n      timeout: { type: 'number', description: 'Request timeout in milliseconds (default: 30000)' },\n    },\n    required: ['url'],\n  },\n  outputSchema: {\n    type: 'object',\n    properties: {\n      status: { type: 'number', description: 'HTTP status code' },\n      headers: { type: 'object', description: 'Response headers' },\n      body: {\n        type: 'object',\n        description:\n          'Response body — parsed object when content-type is application/json, raw string otherwise',\n      },\n    },\n  },\n};\n\nexport async function handler(args: Record<string, unknown>): Promise<ToolResult> {\n  const { url, method, headers, body: requestBody, timeout } = args as unknown as HttpRequestArgs;\n\n  if (!url || typeof url !== 'string') {\n    return { output: null, error: 'http.request: \"url\" is required and must be a string' };\n  }\n\n  try {\n    const controller = new AbortController();\n    const timeoutMs = timeout ?? 30000;\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n    const response = await fetch(url, {\n      method: method ?? 'GET',\n      headers: headers,\n      body: requestBody,\n      signal: controller.signal,\n    });\n\n    clearTimeout(timer);\n\n    const responseText = await response.text();\n    const responseHeaders: Record<string, string> = {};\n    response.headers.forEach((value, key) => {\n      responseHeaders[key] = value;\n    });\n\n    // Auto-parse JSON responses so workflows can access fields directly\n    const contentType = response.headers.get('content-type') ?? '';\n    let responseBody: unknown = responseText;\n    if (contentType.includes('application/json')) {\n      try {\n        responseBody = JSON.parse(responseText);\n      } catch {\n        // Keep raw text if JSON parsing fails\n      }\n    }\n\n    return {\n      output: {\n        status: response.status,\n        headers: responseHeaders,\n        body: responseBody,\n      },\n    };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return { output: null, error: `http.request failed: ${message}` };\n  }\n}\n"],"mappings":";AAYA,MAAa,aAA6B;CACxC,MAAM;CACN,aAAa;CACb,aAAa;EACX,MAAM;EACN,YAAY;GACV,KAAK;IAAE,MAAM;IAAU,aAAa;IAAsB;GAC1D,QAAQ;IAAE,MAAM;IAAU,aAAa;IAA8B;GACrE,SAAS;IAAE,MAAM;IAAU,aAAa;IAAsC;GAC9E,MAAM;IAAE,MAAM;IAAU,aAAa;IAAqC;GAC1E,SAAS;IAAE,MAAM;IAAU,aAAa;IAAoD;GAC7F;EACD,UAAU,CAAC,MAAM;EAClB;CACD,cAAc;EACZ,MAAM;EACN,YAAY;GACV,QAAQ;IAAE,MAAM;IAAU,aAAa;IAAoB;GAC3D,SAAS;IAAE,MAAM;IAAU,aAAa;IAAoB;GAC5D,MAAM;IACJ,MAAM;IACN,aACE;IACH;GACF;EACF;CACF;AAED,eAAsB,QAAQ,MAAoD;CAChF,MAAM,EAAE,KAAK,QAAQ,SAAS,MAAM,aAAa,YAAY;AAE7D,KAAI,CAAC,OAAO,OAAO,QAAQ,SACzB,QAAO;EAAE,QAAQ;EAAM,OAAO;EAAwD;AAGxF,KAAI;EACF,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,WAAW;EAC7B,MAAM,QAAQ,iBAAiB,WAAW,OAAO,EAAE,UAAU;EAE7D,MAAM,WAAW,MAAM,MAAM,KAAK;GAChC,QAAQ,UAAU;GACT;GACT,MAAM;GACN,QAAQ,WAAW;GACpB,CAAC;AAEF,eAAa,MAAM;EAEnB,MAAM,eAAe,MAAM,SAAS,MAAM;EAC1C,MAAM,kBAA0C,EAAE;AAClD,WAAS,QAAQ,SAAS,OAAO,QAAQ;AACvC,mBAAgB,OAAO;IACvB;EAGF,MAAM,cAAc,SAAS,QAAQ,IAAI,eAAe,IAAI;EAC5D,IAAI,eAAwB;AAC5B,MAAI,YAAY,SAAS,mBAAmB,CAC1C,KAAI;AACF,kBAAe,KAAK,MAAM,aAAa;UACjC;AAKV,SAAO,EACL,QAAQ;GACN,QAAQ,SAAS;GACjB,SAAS;GACT,MAAM;GACP,EACF;UACM,KAAK;AAEZ,SAAO;GAAE,QAAQ;GAAM,OAAO,wBADd,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;GACC"}