workflowskill 0.1.0 → 0.2.1

package/skill/SKILL.md

@@ -406,7 +406,7 @@ steps:
 
   - id: fetch_details
     type: tool
-    tool: http.request
+    tool: api.get_item                  # platform-specific tool; use web.scrape for HTML pages
     each: $steps.get_ids.output.ids    # iterate over ids array
     on_error: ignore                    # skip failed fetches, continue
     inputs:
@@ -432,9 +432,9 @@ outputs:
     value: $steps.fetch_details.output   # the collected array of per-iteration results
 ```
 
-**Pattern: List → Fetch Details → Filter → Summarize**
+**Pattern: List → Slice → Fetch Details**
 
-Full example for "fetch Hacker News top stories":
+Full example using generic tool names (substitute platform-specific tools as needed):
 
 ```yaml
 inputs:
@@ -443,19 +443,19 @@ inputs:
     default: 10
   base_url:
     type: string
-    default: "https://hacker-news.firebaseio.com/v0/item/"
+    default: "https://api.example.com/item/"
 
 outputs:
-  stories:
+  items:
     type: array
-    value: $steps.fetch_stories.output
+    value: $steps.fetch_details.output
 
 steps:
-  - id: get_top_ids
+  - id: get_ids
     type: tool
-    tool: http.request
+    tool: api.list_items
     inputs:
-      url: { type: string, value: "https://hacker-news.firebaseio.com/v0/topstories.json" }
+      url: { type: string, value: "https://api.example.com/items" }
     outputs:
       ids: { type: array, value: $result.body }
 
@@ -464,14 +464,16 @@ steps:
     operation: filter
     where: $index < $inputs.count       # cap iteration count to avoid rate limiting
     inputs:
-      items: { type: array, value: $steps.get_top_ids.output.ids }
+      items: { type: array, value: $steps.get_ids.output.ids }
     outputs:
       ids: { type: array }
 
-  - id: fetch_stories
+  - id: fetch_details
     type: tool
-    tool: http.request
+    tool: api.get_item
     each: $steps.slice_ids.output.ids
+    delay: "2s"
+    retry: { max: 3, delay: "2s", backoff: 1.5 }
     on_error: ignore
     inputs:
       url:
@@ -500,8 +502,9 @@ Use plain text output (`value: $result`) for the LLM step, then zip the LLM resu
 steps:
   - id: fetch_items
     type: tool
-    tool: http.request
+    tool: api.get_item                  # platform-specific; use web.scrape for HTML pages
     each: $steps.get_ids.output.ids
+    delay: "2s"
     on_error: ignore
     inputs:
       url:
@@ -594,42 +597,69 @@ outputs:
 
 When a workflow fetches HTML and extracts structured data, follow this recipe:
 
-### Step pattern: fetch → guard → extract
+### Step pattern: scrape → guard
+
+`web.scrape` fetches the URL and applies CSS selectors in one step:
 
 ```yaml
 steps:
-  - id: fetch_page
+  - id: scrape_data
     type: tool
-    tool: http.request
+    tool: web.scrape
     retry: { max: 3, delay: "2s", backoff: 1.5 }
     inputs:
       url: { type: string, value: "https://example.com/search" }
-      method: { type: string, value: "GET" }
       headers:
         type: object
         value: { "User-Agent": "Mozilla/5.0", "Accept": "text/html" }
+      selector: { type: string, value: "li.result-item" }
+      fields:
+        type: object
+        value:
+          title: "h3.title"
+          url: "a.link @href"
+          id: "@data-pid"
+      limit: { type: int, value: 50 }
     outputs:
-      html: { type: string, value: $result.body }
+      items: { type: array, value: $result.results }
 
   - id: guard_empty
     type: exit
-    condition: $steps.fetch_page.output.html == ""
+    condition: $steps.scrape_data.output.items.length == 0
     status: success
     output: { results: [] }
+    inputs: {}
+    outputs: {}
+```
 
-  - id: extract_data
+### Multi-page scraping with `each`
+
+When scraping multiple pages, combine `web.scrape` with `each`:
+
+```yaml
+steps:
+  - id: get_page_list
+    type: tool
+    tool: api.get_sitemap    # returns list of page URLs to scrape
+    outputs:
+      pages:
+        type: array
+
+  - id: scrape_pages
     type: tool
-    tool: html.select
+    tool: web.scrape
+    each: $steps.get_page_list.output.pages
+    delay: "2s"
+    retry: { max: 3, delay: "2s", backoff: 1.5 }
+    on_error: ignore
     inputs:
-      html: { type: string, value: $steps.fetch_page.output.html }
-      selector: { type: string, value: "li.result-item" }
+      url: { type: string, value: $item }
+      selector: { type: string, value: "article.post" }
       fields:
         type: object
         value:
-          title: "h3.title"
-          url: "a.link @href"
-          id: "@data-pid"
-      limit: { type: int, value: 50 }
+          title: "h1.title"
+          body: "div.content"
     outputs:
       items: { type: array, value: $result.results }
 ```
@@ -645,7 +675,7 @@ Follow the Research protocol (Authoring Process, Phase 2) before writing selecto
 3. **Always declare inputs and outputs.** They enable validation and composability.
 4. **Use `value` on workflow outputs** to explicitly map step results to workflow outputs. Use `$steps.<id>.output.<field>` expressions. This is preferred over exit steps for producing output.
 5. **Use `value` on step outputs** to map fields from the raw executor result using `$result`. Required for LLM steps (which return raw text/JSON). Useful for tool steps when the response shape differs from what downstream steps need.
-6. **Use `each` for per-item processing** on both tool and LLM steps. Always include `delay` on every `each` loop that calls an external service — `delay: "2s"` for HTTP tool steps, `delay: "1s"` for LLM steps. See *Iteration Patterns*.
+6. **Use `each` for per-item processing** on both tool and LLM steps. Always include `delay` on every `each` loop that calls an external service — `delay: "2s"` for tool steps (including `web.scrape`), `delay: "1s"` for LLM steps. See *Iteration Patterns*.
 7. **Add `on_error: ignore` for non-critical steps** like notifications.
 8. **Add `retry` for external API calls** (tool steps that might fail transiently).
 9. **Use `condition` guards for early exits** rather than letting empty data flow through.
@@ -657,7 +687,7 @@ Follow the Research protocol (Authoring Process, Phase 2) before writing selecto
 15. **Use `map` with `$index` for cross-array merging.** When multiple steps produce parallel arrays, use a `map` transform with bracket indexing (`$steps.other.output.field[$index]`) to zip them into structured objects. Never use an LLM step for pure data restructuring.
 16. **When JSON output is used, LLM prompts must say "raw JSON only — no markdown fences, no commentary."** Models default to wrapping JSON in ``` fences. The runtime parses the raw text with `JSON.parse`, which rejects fenced output. Every prompt that expects JSON output must explicitly instruct the model to respond with raw JSON. Put this instruction **last** in the prompt, after all data and task description, immediately before the model generates. This exploits recency bias — the last instruction the model sees is the most influential, especially when data references expand to large content that can push earlier instructions out of focus. Also describe the exact expected shape (e.g., "Your entire response must be a valid JSON object starting with { and ending with }").
 17. **Guard expensive steps behind deterministic exits.** Pattern: fetch → filter → exit guard → LLM. Use deterministic expressions (e.g., `$item.department == "Engineering"` or `$item.title contains "Product Manager"`) in `transform filter` steps before any LLM call. See *Patterns*.
-18. **Prefer bulk endpoints over per-item iteration.** When `each` + `http.request` is unavoidable, always add `delay: "2s"` (minimum), cap iteration count, and add `retry` with `backoff`. `delay` is not optional — external APIs rate-limit without warning and delays are free. Same applies to `each` + `llm` steps: always add `delay: "1s"`. See *Iteration Patterns*.
+18. **Prefer bulk endpoints over per-item iteration.** When per-item `each` + tool calls (including `web.scrape`) are unavoidable, always add `delay: "2s"` (minimum), cap iteration count, and add `retry` with `backoff`. `delay` is not optional — external sites and APIs rate-limit without warning and delays are free. Same applies to `each` + `llm` steps: always add `delay: "1s"`. See *Iteration Patterns*.
 19. **Prefer plain text LLM output over JSON.** For single-value tasks (summarization, classification, scoring), use `value: $result` and instruct the model to return plain text. Reserve JSON (`value: $result.field`) for multi-field output where every field requires LLM reasoning. In `each` + LLM patterns, always use plain text + a `map` transform to zip LLM output with structural data from the source array. See *Iteration Patterns*.
 
 ## Output Format
@@ -720,6 +750,6 @@ After writing the file, always validate it against the runtime. The validation c
 - [ ] LLM prompts expecting JSON include "raw JSON only — no markdown fences" instruction
 - [ ] LLM steps with `each` prefer plain text output (`value: $result`) over JSON (`value: $result.field`)
 - [ ] Every `each` loop that calls an external service has `delay` (tool steps: `"2s"` minimum; LLM steps: `"1s"` minimum)
-- [ ] `each` + `http.request` steps are bounded (preceded by a cap) and have `retry` with `backoff`
+- [ ] `each` + `web.scrape` steps are bounded (preceded by a cap) and have `retry` with `backoff`
 
 If validation fails, fix the errors and revalidate.

package/dist/gmail-CYBJ6Dxa.mjs

@@ -1,209 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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

@@ -1,91 +0,0 @@
-//#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

@@ -1 +0,0 @@
-{"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"}