@rnsk/toolkits 0.0.9 → 0.0.10

package/README.md

@@ -16,7 +16,7 @@ Manifest-driven toolkit registry for AI agents — connector definitions you pub
 
 ## Toolkits
 
-**1064 tools** across **34 toolkits** (run `npm run validate` for live counts).
+**1471 tools** across **40 toolkits** (run `npm run validate` for live counts).
 
 | Toolkit | Tools | Auth |
 |---------|------:|------|
@@ -54,6 +54,12 @@ Manifest-driven toolkit registry for AI agents — connector definitions you pub
 | discord | 23 | OAuth2 |
 | gitlab | 25 | OAuth2 |
 | bitbucket | 108 | OAuth2 |
+| hugging-face | 135 | OAuth2 |
+| hostinger | 24 | API key |
+| hacker-news | 14 | none |
+| jira | 103 | OAuth2 |
+| neo4j | 21 | basic auth |
+| neon | 110 | API key |
 
 ## Install
 

package/dist/index.d.ts

@@ -32,9 +32,15 @@ import slack from './toolkits/slack/manifest.js';
 import discord from './toolkits/discord/manifest.js';
 import bitbucket from './toolkits/bitbucket/manifest.js';
 import gitlab from './toolkits/gitlab/manifest.js';
+import huggingFace from './toolkits/hugging-face/manifest.js';
+import hostinger from './toolkits/hostinger/manifest.js';
+import hackerNews from './toolkits/hacker-news/manifest.js';
+import jira from './toolkits/jira/manifest.js';
+import neo4j from './toolkits/neo4j/manifest.js';
+import neon from './toolkits/neon/manifest.js';
 import type { ToolkitManifest } from './core/types.js';
 export declare const toolkits: ToolkitManifest[];
-export { mathematics, linear, gmail, webSearch, github, notion, googleCalendar, googleSheets, googleDrive, googleDocs, googleMaps, googlePhotos, googleContacts, googleForms, googleMeet, googleSlides, googleClassroom, googleTasks, googleSearchConsole, googleAnalytics, googleAds, youtube, figma, aws, gcp, grafana, dockerHub, reddit, groww, cloudflare, slack, discord, gitlab, bitbucket, };
+export { mathematics, linear, gmail, webSearch, github, notion, googleCalendar, googleSheets, googleDrive, googleDocs, googleMaps, googlePhotos, googleContacts, googleForms, googleMeet, googleSlides, googleClassroom, googleTasks, googleSearchConsole, googleAnalytics, googleAds, youtube, figma, aws, gcp, grafana, dockerHub, reddit, groww, cloudflare, slack, discord, gitlab, bitbucket, huggingFace, hostinger, hackerNews, jira, neo4j, neon, };
 export * from './core/index.js';
 export declare function getAllTools(): {
     name: string;

package/dist/index.js

@@ -32,6 +32,12 @@ import slack from './toolkits/slack/manifest.js';
 import discord from './toolkits/discord/manifest.js';
 import bitbucket from './toolkits/bitbucket/manifest.js';
 import gitlab from './toolkits/gitlab/manifest.js';
+import huggingFace from './toolkits/hugging-face/manifest.js';
+import hostinger from './toolkits/hostinger/manifest.js';
+import hackerNews from './toolkits/hacker-news/manifest.js';
+import jira from './toolkits/jira/manifest.js';
+import neo4j from './toolkits/neo4j/manifest.js';
+import neon from './toolkits/neon/manifest.js';
 export const toolkits = [
     mathematics,
     linear,
@@ -67,8 +73,14 @@ export const toolkits = [
     discord,
     gitlab,
     bitbucket,
+    huggingFace,
+    hostinger,
+    hackerNews,
+    jira,
+    neo4j,
+    neon,
 ];
-export { mathematics, linear, gmail, webSearch, github, notion, googleCalendar, googleSheets, googleDrive, googleDocs, googleMaps, googlePhotos, googleContacts, googleForms, googleMeet, googleSlides, googleClassroom, googleTasks, googleSearchConsole, googleAnalytics, googleAds, youtube, figma, aws, gcp, grafana, dockerHub, reddit, groww, cloudflare, slack, discord, gitlab, bitbucket, };
+export { mathematics, linear, gmail, webSearch, github, notion, googleCalendar, googleSheets, googleDrive, googleDocs, googleMaps, googlePhotos, googleContacts, googleForms, googleMeet, googleSlides, googleClassroom, googleTasks, googleSearchConsole, googleAnalytics, googleAds, youtube, figma, aws, gcp, grafana, dockerHub, reddit, groww, cloudflare, slack, discord, gitlab, bitbucket, huggingFace, hostinger, hackerNews, jira, neo4j, neon, };
 export * from './core/index.js';
 export function getAllTools() {
     return toolkits.flatMap((t) => t.tools.map((toolDef) => ({

package/dist/toolkits/hacker-news/icon.d.ts

@@ -0,0 +1,5 @@
+export declare const HACKER_NEWS_ICON: {
+    kind: "svg";
+    dataUri: string;
+};
+//# sourceMappingURL=icon.d.ts.map

package/dist/toolkits/hacker-news/icon.js

@@ -0,0 +1,9 @@
+const SVG = `<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 122.88 122.88" style="enable-background:new 0 0 122.88 122.88" xml:space="preserve"><style type="text/css"><![CDATA[
+	.st0{fill:#FF6600;}
+	.st1{fill:#FFFFFF;}
+]]></style><g><path class="st0" d="M18.43,0h86.02c10.18,0,18.43,8.25,18.43,18.43v86.02c0,10.18-8.25,18.43-18.43,18.43H18.43 C8.25,122.88,0,114.63,0,104.45l0-86.02C0,8.25,8.25,0,18.43,0L18.43,0z"/><polygon class="st1" points="29.76,21.84 42,21.84 61.44,60.72 80.88,21.36 93.12,21.36 66.24,70.32 66.24,102.96 56.64,102.96 56.64,70.32 29.76,21.84"/></g></svg>`;
+export const HACKER_NEWS_ICON = {
+    kind: 'svg',
+    dataUri: `data:image/svg+xml;base64,${Buffer.from(SVG).toString('base64')}`,
+};
+//# sourceMappingURL=icon.js.map

package/dist/toolkits/hacker-news/manifest.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("../../index.js").ToolkitManifest;
+export default _default;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/toolkits/hacker-news/manifest.js

@@ -0,0 +1,25 @@
+import { defineToolkit, defineTool } from '../../core/define.js';
+import { HACKER_NEWS_ICON } from './icon.js';
+import { hackerNewsTools } from './tools/index.js';
+export default defineToolkit({
+    id: 'hacker-news',
+    displayName: 'Hacker News',
+    shortDescription: 'Top stories, discussions, search, items, and user profiles from Hacker News.',
+    category: 'Social Media',
+    icon: HACKER_NEWS_ICON,
+    auth: { type: 'none' },
+    allowedHosts: ['hacker-news.firebaseio.com', 'hn.algolia.com'],
+    tools: hackerNewsTools.map((entry) => defineTool({
+        name: entry.name,
+        description: entry.description,
+        tool: entry.tool,
+        scope: entry.scope,
+    })),
+    meta: {
+        since: '0.0.9',
+        homepage: 'https://news.ycombinator.com',
+        docsUrl: 'https://github.com/HackerNews/API',
+        apiDocsUrl: 'https://github.com/HackerNews/API',
+    },
+});
+//# sourceMappingURL=manifest.js.map

package/dist/toolkits/hacker-news/tools/client.d.ts

@@ -0,0 +1,8 @@
+export declare function hnFirebase(path: string, query?: Record<string, string | number | undefined>): Promise<any>;
+export declare function hnSearch(params: {
+    query?: string;
+    tags?: string[];
+    page?: number;
+    hitsPerPage?: number;
+}): Promise<any>;
+//# sourceMappingURL=client.d.ts.map

package/dist/toolkits/hacker-news/tools/client.js

@@ -0,0 +1,51 @@
+// @ts-nocheck
+const FIREBASE_BASE = 'https://hacker-news.firebaseio.com/v0';
+const ALGOLIA_BASE = 'https://hn.algolia.com/api/v1';
+export async function hnFirebase(path, query = {}) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined && value !== '')
+            params.append(key, String(value));
+    }
+    const qs = params.toString();
+    const url = `${FIREBASE_BASE}${path}${qs ? `?${qs}` : ''}`;
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            return { error: `Hacker News API request failed with status ${response.status}` };
+        }
+        return await response.json();
+    }
+    catch (error) {
+        return {
+            error: 'Error calling Hacker News API',
+            message: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+export async function hnSearch(params) {
+    const search = new URLSearchParams();
+    if (params.query)
+        search.append('query', params.query);
+    if (params.tags && params.tags.length > 0)
+        search.append('tags', `(${params.tags.join(',')})`);
+    if (params.page !== undefined)
+        search.append('page', String(params.page));
+    if (params.hitsPerPage !== undefined)
+        search.append('hitsPerPage', String(params.hitsPerPage));
+    const qs = search.toString();
+    try {
+        const response = await fetch(`${ALGOLIA_BASE}/search${qs ? `?${qs}` : ''}`);
+        if (!response.ok) {
+            return { error: `Hacker News search request failed with status ${response.status}` };
+        }
+        return await response.json();
+    }
+    catch (error) {
+        return {
+            error: 'Error searching Hacker News',
+            message: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/toolkits/hacker-news/tools/index.d.ts

@@ -0,0 +1,89 @@
+import { hackerNewsGetAskStories, hackerNewsGetBestStories, hackerNewsGetJobStories, hackerNewsGetNewStories, hackerNewsGetShowStories, hackerNewsGetTopStories, hackerNewsGetMaxItemId, hackerNewsGetUpdates } from './stories.js';
+import { hackerNewsGetItem, hackerNewsGetItemWithId, hackerNewsGetUser, hackerNewsGetUserByUsername } from './items.js';
+import { hackerNewsGetLatestPosts, hackerNewsSearchPosts } from './search.js';
+export { hackerNewsGetAskStories, hackerNewsGetBestStories, hackerNewsGetJobStories, hackerNewsGetNewStories, hackerNewsGetShowStories, hackerNewsGetTopStories, hackerNewsGetMaxItemId, hackerNewsGetUpdates, hackerNewsGetItem, hackerNewsGetItemWithId, hackerNewsGetUser, hackerNewsGetUserByUsername, hackerNewsGetLatestPosts, hackerNewsSearchPosts, };
+export declare const hackerNewsTools: ({
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        print?: string | undefined;
+    }, any>;
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        printFormat?: string | undefined;
+    }, any>;
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        id: number;
+    }, any>;
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        itemId: string;
+        maxDepth?: number | undefined;
+        maxChildren?: number | undefined;
+        truncateText?: boolean | undefined;
+    }, {
+        found: boolean;
+        item: null;
+        errorMessage: string;
+    } | {
+        found: boolean;
+        item: {
+            id: unknown;
+            type: unknown;
+            author: {} | null;
+            title: unknown;
+            url: {} | null;
+            text: unknown;
+            points: {} | null;
+            parentId: {} | null;
+            storyId: null;
+            createdAt: string | null;
+            createdAtI: {} | null;
+            options: {} | null;
+            children: unknown[];
+            childrenShown: number;
+            totalChildrenCount: number;
+            childrenTruncated: boolean;
+            maxDepthReached: boolean;
+        };
+        errorMessage?: undefined;
+    }>;
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        username: string;
+    }, any>;
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        size?: number | undefined;
+        page?: number | undefined;
+        tags?: string[] | undefined;
+    }, any>;
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        query: string;
+        size?: number | undefined;
+        page?: number | undefined;
+        tags?: string[] | undefined;
+    }, any>;
+    scope: "read";
+})[];
+//# sourceMappingURL=index.d.ts.map

package/dist/toolkits/hacker-news/tools/index.js

@@ -0,0 +1,22 @@
+// @ts-nocheck
+import { hackerNewsGetAskStories, hackerNewsGetBestStories, hackerNewsGetJobStories, hackerNewsGetNewStories, hackerNewsGetShowStories, hackerNewsGetTopStories, hackerNewsGetMaxItemId, hackerNewsGetUpdates, } from './stories.js';
+import { hackerNewsGetItem, hackerNewsGetItemWithId, hackerNewsGetUser, hackerNewsGetUserByUsername, } from './items.js';
+import { hackerNewsGetLatestPosts, hackerNewsSearchPosts } from './search.js';
+export { hackerNewsGetAskStories, hackerNewsGetBestStories, hackerNewsGetJobStories, hackerNewsGetNewStories, hackerNewsGetShowStories, hackerNewsGetTopStories, hackerNewsGetMaxItemId, hackerNewsGetUpdates, hackerNewsGetItem, hackerNewsGetItemWithId, hackerNewsGetUser, hackerNewsGetUserByUsername, hackerNewsGetLatestPosts, hackerNewsSearchPosts, };
+export const hackerNewsTools = [
+    { name: 'HackerNewsGetAskStories', description: hackerNewsGetAskStories.description, tool: hackerNewsGetAskStories, scope: 'read' },
+    { name: 'HackerNewsGetBestStories', description: hackerNewsGetBestStories.description, tool: hackerNewsGetBestStories, scope: 'read' },
+    { name: 'HackerNewsGetJobStories', description: hackerNewsGetJobStories.description, tool: hackerNewsGetJobStories, scope: 'read' },
+    { name: 'HackerNewsGetNewStories', description: hackerNewsGetNewStories.description, tool: hackerNewsGetNewStories, scope: 'read' },
+    { name: 'HackerNewsGetShowStories', description: hackerNewsGetShowStories.description, tool: hackerNewsGetShowStories, scope: 'read' },
+    { name: 'HackerNewsGetTopStories', description: hackerNewsGetTopStories.description, tool: hackerNewsGetTopStories, scope: 'read' },
+    { name: 'HackerNewsGetMaxItemId', description: hackerNewsGetMaxItemId.description, tool: hackerNewsGetMaxItemId, scope: 'read' },
+    { name: 'HackerNewsGetUpdates', description: hackerNewsGetUpdates.description, tool: hackerNewsGetUpdates, scope: 'read' },
+    { name: 'HackerNewsGetItem', description: hackerNewsGetItem.description, tool: hackerNewsGetItem, scope: 'read' },
+    { name: 'HackerNewsGetItemWithId', description: hackerNewsGetItemWithId.description, tool: hackerNewsGetItemWithId, scope: 'read' },
+    { name: 'HackerNewsGetUser', description: hackerNewsGetUser.description, tool: hackerNewsGetUser, scope: 'read' },
+    { name: 'HackerNewsGetUserByUsername', description: hackerNewsGetUserByUsername.description, tool: hackerNewsGetUserByUsername, scope: 'read' },
+    { name: 'HackerNewsGetLatestPosts', description: hackerNewsGetLatestPosts.description, tool: hackerNewsGetLatestPosts, scope: 'read' },
+    { name: 'HackerNewsSearchPosts', description: hackerNewsSearchPosts.description, tool: hackerNewsSearchPosts, scope: 'read' },
+];
+//# sourceMappingURL=index.js.map

package/dist/toolkits/hacker-news/tools/items.d.ts

@@ -0,0 +1,42 @@
+export declare const hackerNewsGetItem: import("ai").Tool<{
+    id: number;
+}, any>;
+export declare const hackerNewsGetItemWithId: import("ai").Tool<{
+    itemId: string;
+    maxDepth?: number | undefined;
+    maxChildren?: number | undefined;
+    truncateText?: boolean | undefined;
+}, {
+    found: boolean;
+    item: null;
+    errorMessage: string;
+} | {
+    found: boolean;
+    item: {
+        id: unknown;
+        type: unknown;
+        author: {} | null;
+        title: unknown;
+        url: {} | null;
+        text: unknown;
+        points: {} | null;
+        parentId: {} | null;
+        storyId: null;
+        createdAt: string | null;
+        createdAtI: {} | null;
+        options: {} | null;
+        children: unknown[];
+        childrenShown: number;
+        totalChildrenCount: number;
+        childrenTruncated: boolean;
+        maxDepthReached: boolean;
+    };
+    errorMessage?: undefined;
+}>;
+export declare const hackerNewsGetUser: import("ai").Tool<{
+    username: string;
+}, any>;
+export declare const hackerNewsGetUserByUsername: import("ai").Tool<{
+    username: string;
+}, any>;
+//# sourceMappingURL=items.d.ts.map

package/dist/toolkits/hacker-news/tools/items.js

@@ -0,0 +1,126 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { hnFirebase } from './client.js';
+export const hackerNewsGetItem = tool({
+    description: 'Get a Hacker News item (story, comment, job, poll, or pollopt) by its numeric ID. Returns author, score, title, text, timestamps, and comment IDs.',
+    inputSchema: z.object({
+        id: z.number().int().positive().describe('Unique numeric ID of the item to retrieve'),
+    }),
+    execute: async ({ id }) => {
+        const item = await hnFirebase(`/item/${id}.json`);
+        if (item && typeof item === 'object' && 'error' in item)
+            return item;
+        if (item === null)
+            return { error: `Hacker News item ${id} not found` };
+        return item;
+    },
+});
+function truncate(text, enabled) {
+    if (!enabled || typeof text !== 'string' || text.length <= 500)
+        return text;
+    return text.slice(0, 500);
+}
+async function resolveChildren(kids, depth, maxDepth, maxChildren, truncateText) {
+    if (depth > maxDepth || !kids || kids.length === 0 || maxChildren === 0) {
+        return { children: [], truncated: (kids?.length ?? 0) > 0 && depth <= maxDepth && maxChildren === 0, depthReached: depth > maxDepth };
+    }
+    const shown = kids.slice(0, maxChildren);
+    const children = [];
+    for (const kidId of shown) {
+        const raw = await hnFirebase(`/item/${kidId}.json`);
+        if (!raw || typeof raw !== 'object' || 'error' in raw || raw === null)
+            continue;
+        const item = raw;
+        const nested = await resolveChildren(item.kids, depth + 1, maxDepth, maxChildren, truncateText);
+        children.push({
+            id: item.id,
+            type: item.type,
+            author: item.by ?? null,
+            text: truncate(item.text ?? null, truncateText),
+            createdAt: typeof item.time === 'number' ? new Date(item.time * 1000).toISOString() : null,
+            createdAtI: item.time ?? null,
+            parentId: item.parent ?? null,
+            children: nested.children,
+            childrenTruncated: nested.truncated,
+            maxDepthReached: nested.depthReached,
+        });
+    }
+    return { children, truncated: kids.length > shown.length, depthReached: false };
+}
+export const hackerNewsGetItemWithId = tool({
+    description: 'Get a Hacker News item with nested comment replies. Limits depth, child count, and text length to prevent context overflow. Use for reading stories with their discussion.',
+    inputSchema: z.object({
+        itemId: z.string().describe('Numeric ID of the item (story, comment, job, poll, or pollopt)'),
+        maxDepth: z.number().int().min(0).max(10).optional().describe('Nested reply depth to include (0 = no children). Defaults to 2.'),
+        maxChildren: z.number().int().min(0).max(100).optional().describe('Direct child comments per item. Defaults to 10.'),
+        truncateText: z.boolean().optional().describe('Truncate long text to 500 characters. Defaults to true.'),
+    }),
+    execute: async ({ itemId, maxDepth = 2, maxChildren = 10, truncateText = true, }) => {
+        const id = Number(itemId);
+        if (!Number.isInteger(id) || id <= 0) {
+            return { found: false, item: null, errorMessage: `Invalid item ID: ${itemId}` };
+        }
+        const raw = await hnFirebase(`/item/${id}.json`);
+        if (raw && typeof raw === 'object' && 'error' in raw) {
+            return { found: false, item: null, errorMessage: raw.error };
+        }
+        if (raw === null) {
+            return { found: false, item: null, errorMessage: `Item ${id} not found` };
+        }
+        const item = raw;
+        const nested = await resolveChildren(item.kids, 1, maxDepth, maxChildren, truncateText);
+        return {
+            found: true,
+            item: {
+                id: item.id,
+                type: item.type,
+                author: item.by ?? null,
+                title: truncate(item.title ?? null, truncateText),
+                url: item.url ?? null,
+                text: truncate(item.text ?? null, truncateText),
+                points: item.score ?? null,
+                parentId: item.parent ?? null,
+                storyId: null,
+                createdAt: typeof item.time === 'number' ? new Date(item.time * 1000).toISOString() : null,
+                createdAtI: item.time ?? null,
+                options: item.parts ?? null,
+                children: nested.children,
+                childrenShown: nested.children.length,
+                totalChildrenCount: Array.isArray(item.kids) ? item.kids.length : 0,
+                childrenTruncated: nested.truncated,
+                maxDepthReached: nested.depthReached,
+            },
+        };
+    },
+});
+export const hackerNewsGetUser = tool({
+    description: 'Get a Hacker News user public profile by username. Returns username, karma, and bio. Use to look up HN community members.',
+    inputSchema: z.object({
+        username: z.string().describe('Case-sensitive HN username, e.g. "pg"'),
+    }),
+    execute: async ({ username }) => {
+        const user = await hnFirebase(`/user/${username}.json`);
+        if (user && typeof user === 'object' && 'error' in user)
+            return user;
+        if (user === null)
+            return { error: `Hacker News user "${username}" not found` };
+        const u = user;
+        return { username: u.id, karma: u.karma, about: u.about ?? null };
+    },
+});
+export const hackerNewsGetUserByUsername = tool({
+    description: 'Get detailed Hacker News user info by username, including creation date, karma, bio, and submission history.',
+    inputSchema: z.object({
+        username: z.string().describe('Case-sensitive HN username, e.g. "pg"'),
+    }),
+    execute: async ({ username }) => {
+        const user = await hnFirebase(`/user/${username}.json`);
+        if (user && typeof user === 'object' && 'error' in user)
+            return user;
+        if (user === null)
+            return { error: `Hacker News user "${username}" not found` };
+        return user;
+    },
+});
+//# sourceMappingURL=items.js.map

package/dist/toolkits/hacker-news/tools/search.d.ts

@@ -0,0 +1,12 @@
+export declare const hackerNewsGetLatestPosts: import("ai").Tool<{
+    size?: number | undefined;
+    page?: number | undefined;
+    tags?: string[] | undefined;
+}, any>;
+export declare const hackerNewsSearchPosts: import("ai").Tool<{
+    query: string;
+    size?: number | undefined;
+    page?: number | undefined;
+    tags?: string[] | undefined;
+}, any>;
+//# sourceMappingURL=search.d.ts.map

package/dist/toolkits/hacker-news/tools/search.js

@@ -0,0 +1,40 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { hnSearch } from './client.js';
+const tagsField = z
+    .array(z.string())
+    .optional()
+    .describe('Filter tags (ANDed). Available: story, comment, poll, pollopt, show_hn, ask_hn, front_page, author_<USERNAME>, story_<ID>.');
+export const hackerNewsGetLatestPosts = tool({
+    description: 'Get latest Hacker News posts with optional tag filters. Use to browse recent stories or comments, optionally filtered by type or author.',
+    inputSchema: z.object({
+        page: z.number().int().min(0).optional().describe('Page number, 0-indexed. Defaults to 0.'),
+        size: z.number().int().min(0).optional().describe('Max results to return. Defaults to 5. Set to 0 for the full page (up to 20).'),
+        tags: tagsField,
+    }),
+    execute: async ({ page = 0, size = 5, tags }) => {
+        const result = await hnSearch({ page, hitsPerPage: size && size > 0 ? size : 20, tags });
+        if (result && typeof result === 'object' && 'error' in result)
+            return result;
+        const hits = Array.isArray(result.hits) ? result.hits : [];
+        return { ...result, hits: size && size > 0 ? hits.slice(0, size) : hits };
+    },
+});
+export const hackerNewsSearchPosts = tool({
+    description: 'Full-text search of Hacker News stories and comments via Algolia. Supports AND/OR/NOT operators plus tag and author filters.',
+    inputSchema: z.object({
+        query: z.string().describe('Full-text search query'),
+        page: z.number().int().min(0).optional().describe('Page number, 0-indexed. Defaults to 0.'),
+        size: z.number().int().min(0).optional().describe('Max results to return. Defaults to 5. Set to 0 for the full page (up to 20).'),
+        tags: tagsField,
+    }),
+    execute: async ({ query, page = 0, size = 5, tags, }) => {
+        const result = await hnSearch({ query, page, hitsPerPage: size && size > 0 ? size : 20, tags });
+        if (result && typeof result === 'object' && 'error' in result)
+            return result;
+        const hits = Array.isArray(result.hits) ? result.hits : [];
+        return { ...result, hits: size && size > 0 ? hits.slice(0, size) : hits };
+    },
+});
+//# sourceMappingURL=search.js.map

package/dist/toolkits/hacker-news/tools/stories.d.ts

@@ -0,0 +1,25 @@
+export declare const hackerNewsGetAskStories: import("ai").Tool<{
+    print?: string | undefined;
+}, any>;
+export declare const hackerNewsGetBestStories: import("ai").Tool<{
+    print?: string | undefined;
+}, any>;
+export declare const hackerNewsGetJobStories: import("ai").Tool<{
+    printFormat?: string | undefined;
+}, any>;
+export declare const hackerNewsGetNewStories: import("ai").Tool<{
+    printFormat?: string | undefined;
+}, any>;
+export declare const hackerNewsGetShowStories: import("ai").Tool<{
+    printFormat?: string | undefined;
+}, any>;
+export declare const hackerNewsGetTopStories: import("ai").Tool<{
+    print?: string | undefined;
+}, any>;
+export declare const hackerNewsGetMaxItemId: import("ai").Tool<{
+    print?: string | undefined;
+}, any>;
+export declare const hackerNewsGetUpdates: import("ai").Tool<{
+    print?: string | undefined;
+}, any>;
+//# sourceMappingURL=stories.d.ts.map

package/dist/toolkits/hacker-news/tools/stories.js

@@ -0,0 +1,98 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { hnFirebase } from './client.js';
+const prettyField = z
+    .string()
+    .optional()
+    .describe("Set to 'pretty' for formatted JSON output. Leave unset for compact JSON.");
+function feedTool(name, description, endpoint, resultKey) {
+    return tool({
+        description,
+        inputSchema: z.object({
+            print: prettyField,
+        }),
+        execute: async ({ print }) => {
+            const ids = await hnFirebase(`/${endpoint}.json`, print ? { print } : {});
+            if (ids && typeof ids === 'object' && 'error' in ids)
+                return ids;
+            return { [resultKey]: ids, count: Array.isArray(ids) ? ids.length : 0 };
+        },
+    });
+}
+export const hackerNewsGetAskStories = feedTool('ask', 'Get up to 200 latest Ask HN story IDs in ranked order. Use the IDs with HackerNewsGetItem to fetch full story details.', 'askstories', 'storyIds');
+export const hackerNewsGetBestStories = feedTool('best', 'Get up to 500 best Hacker News story IDs ranked by score. Use the IDs with HackerNewsGetItem to fetch full story details.', 'beststories', 'storyIds');
+export const hackerNewsGetJobStories = tool({
+    description: 'Get up to 200 latest Hacker News job story IDs. Use the IDs with HackerNewsGetItem to fetch full job details.',
+    inputSchema: z.object({
+        printFormat: z
+            .string()
+            .optional()
+            .describe("Set to 'pretty' for formatted JSON output. Leave unset for compact JSON."),
+    }),
+    execute: async ({ printFormat }) => {
+        const ids = await hnFirebase('/jobstories.json', printFormat ? { print: printFormat } : {});
+        if (ids && typeof ids === 'object' && 'error' in ids)
+            return ids;
+        return { jobStoryIds: ids, count: Array.isArray(ids) ? ids.length : 0 };
+    },
+});
+export const hackerNewsGetNewStories = tool({
+    description: 'Get up to 500 newest Hacker News story IDs, most recent first. Use the IDs with HackerNewsGetItem to fetch full story details.',
+    inputSchema: z.object({
+        printFormat: z
+            .string()
+            .optional()
+            .describe("Set to 'pretty' for formatted JSON output. Leave unset for compact JSON."),
+    }),
+    execute: async ({ printFormat }) => {
+        const ids = await hnFirebase('/newstories.json', printFormat ? { print: printFormat } : {});
+        if (ids && typeof ids === 'object' && 'error' in ids)
+            return ids;
+        return { storyIds: ids, count: Array.isArray(ids) ? ids.length : 0 };
+    },
+});
+export const hackerNewsGetShowStories = tool({
+    description: 'Get up to 200 latest Show HN story IDs where people share projects and products. Use the IDs with HackerNewsGetItem to fetch full details.',
+    inputSchema: z.object({
+        printFormat: z
+            .string()
+            .optional()
+            .describe("Set to 'pretty' for formatted JSON output. Leave unset for compact JSON."),
+    }),
+    execute: async ({ printFormat }) => {
+        const ids = await hnFirebase('/showstories.json', printFormat ? { print: printFormat } : {});
+        if (ids && typeof ids === 'object' && 'error' in ids)
+            return ids;
+        return { storyIds: ids, count: Array.isArray(ids) ? ids.length : 0 };
+    },
+});
+export const hackerNewsGetTopStories = feedTool('top', 'Get up to 500 top Hacker News story IDs in front-page order. Use the IDs with HackerNewsGetItem to fetch full story details.', 'topstories', 'storyIds');
+export const hackerNewsGetMaxItemId = tool({
+    description: 'Get the current largest Hacker News item ID. Use to discover the most recent items or walk backward through all items.',
+    inputSchema: z.object({
+        print: z
+            .string()
+            .optional()
+            .describe("Set to 'pretty' for formatted JSON output. Leave unset for compact JSON."),
+    }),
+    execute: async ({ print }) => {
+        const maxId = await hnFirebase('/maxitem.json', print ? { print } : {});
+        if (maxId && typeof maxId === 'object' && 'error' in maxId)
+            return maxId;
+        return { maxItemId: maxId };
+    },
+});
+export const hackerNewsGetUpdates = tool({
+    description: 'Get recently changed Hacker News item IDs and user profiles. Use to monitor recent activity on the platform.',
+    inputSchema: z.object({
+        print: z
+            .string()
+            .optional()
+            .describe("Set to 'pretty' for formatted JSON output. Leave unset for compact JSON."),
+    }),
+    execute: async ({ print }) => {
+        return hnFirebase('/updates.json', print ? { print } : {});
+    },
+});
+//# sourceMappingURL=stories.js.map

package/dist/toolkits/hostinger/icon.d.ts

@@ -0,0 +1,5 @@
+export declare const HOSTINGER_ICON: {
+    kind: "svg";
+    dataUri: string;
+};
+//# sourceMappingURL=icon.d.ts.map

package/dist/toolkits/hostinger/icon.js

@@ -0,0 +1,6 @@
+const SVG = `<svg viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd" stroke-linejoin="round" stroke-miterlimit="2"><path d="M347.979 6v149.166l120.52 70.5V67.437L347.98 6zM43.499 6v234.104h391.98L316.207 174.54l-155.354-.062V68.999L43.5 6zm304.48 435.291V336.729l-156.542-.105c.146.688-121.25-66.604-121.25-66.604l398.312 1.896V506l-120.52-64.708zM43.499 288.312v152.979l117.355 61.437V357.145L43.5 288.312z" fill="#673de6" fill-rule="nonzero"/></svg>`;
+export const HOSTINGER_ICON = {
+    kind: 'svg',
+    dataUri: `data:image/svg+xml;base64,${Buffer.from(SVG).toString('base64')}`,
+};
+//# sourceMappingURL=icon.js.map