@rnsk/toolkits 0.0.1

package/dist/toolkits/web-search/tools/firecrawl-client.d.ts

@@ -0,0 +1,4 @@
+import Firecrawl from 'firecrawl';
+export declare function createFirecrawlClient(apiKey?: string): Firecrawl;
+export declare function extractSnippet(entry: Record<string, unknown>): string;
+//# sourceMappingURL=firecrawl-client.d.ts.map

package/dist/toolkits/web-search/tools/firecrawl-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firecrawl-client.d.ts","sourceRoot":"","sources":["../../../../src/toolkits/web-search/tools/firecrawl-client.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAGhE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQrE"}

package/dist/toolkits/web-search/tools/firecrawl-client.js

@@ -0,0 +1,15 @@
+import Firecrawl from 'firecrawl';
+export function createFirecrawlClient(apiKey) {
+    const key = apiKey ?? process.env.FIRECRAWL_API_KEY;
+    return new Firecrawl(key ? { apiKey: key } : {});
+}
+export function extractSnippet(entry) {
+    if (typeof entry.markdown === 'string' && entry.markdown.trim()) {
+        return entry.markdown.trim().slice(0, 500);
+    }
+    if (typeof entry.description === 'string' && entry.description.trim()) {
+        return entry.description.trim();
+    }
+    return '';
+}
+//# sourceMappingURL=firecrawl-client.js.map

package/dist/toolkits/web-search/tools/firecrawl-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firecrawl-client.js","sourceRoot":"","sources":["../../../../src/toolkits/web-search/tools/firecrawl-client.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACpD,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAA8B;IAC3D,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/toolkits/web-search/tools/web-scrape.d.ts

@@ -0,0 +1,18 @@
+export declare const webScrape: import("ai").Tool<{
+    url: string;
+}, {
+    url: string;
+    title: string;
+    markdown: string;
+    snippet: string;
+    error?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    url?: undefined;
+    title?: undefined;
+    markdown?: undefined;
+    snippet?: undefined;
+}>;
+//# sourceMappingURL=web-scrape.d.ts.map

package/dist/toolkits/web-search/tools/web-scrape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-scrape.d.ts","sourceRoot":"","sources":["../../../../src/toolkits/web-search/tools/web-scrape.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;EA4BpB,CAAC"}

package/dist/toolkits/web-search/tools/web-scrape.js

@@ -0,0 +1,30 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { createFirecrawlClient, extractSnippet } from './firecrawl-client.js';
+export const webScrape = tool({
+    description: 'Scrape a specific URL and return its page content as markdown. Use this when you already have a URL and need the full page text.',
+    inputSchema: z.object({
+        url: z.string().url().describe('The URL to scrape'),
+    }),
+    execute: async ({ url }) => {
+        try {
+            const firecrawl = createFirecrawlClient();
+            const document = await firecrawl.scrape(url, { formats: ['markdown', 'html'] });
+            const record = document;
+            const markdown = typeof record.markdown === 'string' ? record.markdown.trim() : extractSnippet(record);
+            return {
+                url,
+                title: typeof record.title === 'string' ? record.title : '',
+                markdown,
+                snippet: markdown.slice(0, 500),
+            };
+        }
+        catch (err) {
+            return {
+                error: 'Web scrape failed',
+                message: err instanceof Error ? err.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=web-scrape.js.map

package/dist/toolkits/web-search/tools/web-scrape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-scrape.js","sourceRoot":"","sources":["../../../../src/toolkits/web-search/tools/web-scrape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;IAC5B,WAAW,EACT,kIAAkI;IACpI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KACpD,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,qBAAqB,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YAEhF,MAAM,MAAM,GAAG,QAAmC,CAAC;YACnD,MAAM,QAAQ,GACZ,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAExF,OAAO;gBACL,GAAG;gBACH,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBAC3D,QAAQ;gBACR,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aAChC,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,KAAK,EAAE,mBAAmB;gBAC1B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/toolkits/web-search/tools/web-search.d.ts

@@ -0,0 +1,23 @@
+type WebSearchResult = {
+    title: string;
+    url: string;
+    snippet: string;
+};
+export declare const webSearch: import("ai").Tool<{
+    query: string;
+    maxResults: number;
+}, {
+    query: string;
+    count: number;
+    results: WebSearchResult[];
+    error?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    query?: undefined;
+    count?: undefined;
+    results?: undefined;
+}>;
+export {};
+//# sourceMappingURL=web-search.d.ts.map

package/dist/toolkits/web-search/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../../src/toolkits/web-search/tools/web-search.ts"],"names":[],"mappings":"AAIA,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAgBF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;EAkCpB,CAAC"}

package/dist/toolkits/web-search/tools/web-search.js

@@ -0,0 +1,50 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { createFirecrawlClient, extractSnippet } from './firecrawl-client.js';
+function mapSearchEntry(entry) {
+    if (!entry || typeof entry !== 'object')
+        return null;
+    const record = entry;
+    const url = typeof record.url === 'string' ? record.url : '';
+    if (!url)
+        return null;
+    return {
+        title: typeof record.title === 'string' ? record.title : '',
+        url,
+        snippet: extractSnippet(record),
+    };
+}
+export const webSearch = tool({
+    description: 'Search the web for current information. Use this when you need up-to-date facts, news, or general web results. Returns a list of results with title, url, and snippet.',
+    inputSchema: z.object({
+        query: z.string().describe('The search query'),
+        maxResults: z
+            .number()
+            .min(1)
+            .max(20)
+            .optional()
+            .default(5)
+            .describe('Maximum number of results to return (1-20, default 5)'),
+    }),
+    execute: async ({ query, maxResults = 5 }) => {
+        try {
+            const firecrawl = createFirecrawlClient();
+            const response = await firecrawl.search(query, {
+                limit: maxResults,
+                scrapeOptions: { formats: ['markdown'] },
+            });
+            const webEntries = response.web ?? [];
+            const results = webEntries
+                .map((entry) => mapSearchEntry(entry))
+                .filter((entry) => entry != null);
+            return { query, count: results.length, results };
+        }
+        catch (err) {
+            return {
+                error: 'Web search failed',
+                message: err instanceof Error ? err.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=web-search.js.map

package/dist/toolkits/web-search/tools/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../../../src/toolkits/web-search/tools/web-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ9E,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAErD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,OAAO;QACL,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC3D,GAAG;QACH,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;IAC5B,WAAW,EACT,wKAAwK;IAC1K,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC9C,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,EAAE;aACV,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CAAC,uDAAuD,CAAC;KACrE,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,GAAG,CAAC,EAAE,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,qBAAqB,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE;gBAC7C,KAAK,EAAE,UAAU;gBACjB,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE;aACzC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,UAAU;iBACvB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;iBACrC,MAAM,CAAC,CAAC,KAAK,EAA4B,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;YAE9D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,KAAK,EAAE,mBAAmB;gBAC1B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@rnsk/toolkits",
+  "version": "0.0.1",
+  "description": "Runstack toolkit registry — manifest-driven tool definitions for AI agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "gen": "tsx scripts/gen-index.ts",
+    "validate": "tsx scripts/validate.ts",
+    "build": "npm run gen && tsc",
+    "prepublishOnly": "npm run validate && npm run build"
+  },
+  "peerDependencies": {
+    "ai": "^6.0.0",
+    "zod": "^3.23.0 || ^4.0.0"
+  },
+  "dependencies": {
+    "firecrawl": "^4.38.0",
+    "zod-to-json-schema": "^3.25.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "ai": "^6.0.62",
+    "tsx": "^4.19.3",
+    "typescript": "^5",
+    "zod": "^3.24.2"
+  }
+}