@rnsk/toolkits 0.0.9 → 0.0.11

package/dist/toolkits/kaggle/tools/kernels.js

@@ -0,0 +1,121 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import fs from 'node:fs';
+import pathMod from 'node:path';
+import { kaggle } from './client.js';
+const KERNEL_METADATA_TEMPLATE = {
+    id: 'USERNAME/KERNEL-SLUG',
+    title: 'Kernel Title',
+    code_file: 'notebook.ipynb',
+    language: 'python',
+    kernel_type: 'notebook',
+    is_private: true,
+    enable_gpu: false,
+    enable_internet: false,
+    dataset_sources: [],
+    competition_sources: [],
+    kernel_sources: [],
+    model_sources: [],
+};
+const tokenField = z.string().optional().describe('Injected by system; do not provide');
+export const kaggleKernelInit = tool({
+    description: "Initialize a kernel-metadata.json template file in a specified folder. This file is required before pushing/uploading a kernel to Kaggle. The template includes default values for kernel configuration (language, kernel_type, GPU settings, etc.) that can be customized before pushing. Use this when setting up a new Kaggle kernel locally.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        path: z.string().optional().describe("Folder path where kernel-metadata.json will be created. Use '.' for current directory or provide an absolute/relative path."),
+    }),
+    execute: async ({ kaggleCredentials, path }) => {
+        try {
+            const dir = path ?? '.';
+            fs.mkdirSync(dir, { recursive: true });
+            const filePath = pathMod.join(dir, 'kernel-metadata.json');
+            if (fs.existsSync(filePath)) {
+                return { metadata_path: filePath, note: 'kernel-metadata.json already exists, left unchanged' };
+            }
+            fs.writeFileSync(filePath, JSON.stringify(KERNEL_METADATA_TEMPLATE, null, 2));
+            return { metadata_path: filePath };
+        }
+        catch (error) {
+            return { error: 'Error initializing kernel metadata', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+export const kaggleKernelOutput = tool({
+    description: "Tool to download the output of a Kaggle kernel. Use when needing the latest kernel results locally.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        path: z.string().optional().describe("Deprecated. Local download paths are no longer returned."),
+        force: z.boolean().optional().describe("Deprecated. Local file caching is no longer used."),
+        userName: z.string().describe("Owner of the kernel."),
+        kernelSlug: z.string().describe("Slug name of the kernel."),
+    }),
+    execute: async ({ kaggleCredentials, path, force, userName, kernelSlug }) => {
+        const queryParams = undefined;
+        return kaggle(kaggleCredentials, { path: `/kernels/${encodeURIComponent(userName)}/${encodeURIComponent(kernelSlug)}/output`, method: 'GET', query: queryParams });
+    },
+});
+export const kaggleKernelsStatus = tool({
+    description: "Get the execution status of a Kaggle kernel (notebook). Returns current status (running, complete, error), timestamps, and output URL. Use this to monitor kernel execution after pushing/submitting a kernel. Note: You need permission to access the kernel - typically only your own kernels or public kernels you have access to.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        userName: z.string().describe("Username of the kernel owner (typically your Kaggle username for your own kernels)"),
+        kernelSlug: z.string().describe("URL-friendly identifier (slug) of the kernel, typically lowercase with hyphens (e.g., 'my-analysis-notebook')"),
+    }),
+    execute: async ({ kaggleCredentials, userName, kernelSlug }) => {
+        const queryParams = undefined;
+        return kaggle(kaggleCredentials, { path: `/kernels/${encodeURIComponent(userName)}/${encodeURIComponent(kernelSlug)}/status`, method: 'GET', query: queryParams });
+    },
+});
+export const kaggleListKernelOutputFiles = tool({
+    description: "Tool to list output files for a specific kernel run. Use when you need to retrieve paginated file listings by kernel owner and slug.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        pageSize: z.number().int().optional().describe("Number of items per page (default: 20, max: 200)."),
+        userName: z.string().describe("Kernel owner username."),
+        pageToken: z.string().optional().describe("Page token for results paging."),
+        kernelSlug: z.string().describe("Kernel slug/name."),
+    }),
+    execute: async ({ kaggleCredentials, pageSize, userName, pageToken, kernelSlug }) => {
+        const queryParams = { page_size: pageSize, page_token: pageToken };
+        return kaggle(kaggleCredentials, { path: `/kernels/${encodeURIComponent(userName)}/${encodeURIComponent(kernelSlug)}/output/files`, method: 'GET', query: queryParams });
+    },
+});
+export const kaggleListKernels = tool({
+    description: "Tool to list Kaggle kernels (notebooks and scripts) with filters and pagination. Use to discover kernels by search terms, user, language, type, competition, or dataset.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        page: z.number().int().optional().describe("Page number for paginated results. Default: 1."),
+        user: z.string().optional().describe("Filter kernels by a specific user or organization username."),
+        group: z.enum(["everyone", "profile", "upvoted"]).optional().describe("Groups for filtering kernels."),
+        search: z.string().optional().describe("Search terms to filter kernels by title, code, or author."),
+        sortBy: z.enum(["hotness", "commentCount", "dateCreated", "dateRun", "scoreAscending", "scoreDescending", "viewCount", "voteCount", "relevance"]).optional().describe("Sort options for kernel listings."),
+        dataset: z.string().optional().describe("Filter kernels that use a specific dataset (format: owner/dataset-name)."),
+        language: z.enum(["all", "python", "r", "sqlite", "julia"]).optional().describe("Programming languages supported by Kaggle kernels."),
+        pageSize: z.number().int().optional().describe("Number of kernels per page. Default: 20."),
+        kernelType: z.enum(["all", "script", "notebook"]).optional().describe("Types of Kaggle kernels."),
+        outputType: z.enum(["all", "visualization", "data"]).optional().describe("Output types for Kaggle kernels."),
+        competition: z.string().optional().describe("Filter kernels associated with a specific competition (format: competition-slug)."),
+        parentKernel: z.string().optional().describe("Filter kernels that have forked the specified kernel (format: owner/kernel-name)."),
+    }),
+    execute: async ({ kaggleCredentials, page, user, group, search, sortBy, dataset, language, pageSize, kernelType, outputType, competition, parentKernel }) => {
+        const queryParams = { pageSize: pageSize, user: user, group: group, search: search, sortBy: sortBy, dataset: dataset, kernelType: kernelType, outputType: outputType, competition: competition, parentKernel: parentKernel };
+        return kaggle(kaggleCredentials, { path: `/kernels`, method: 'GET', query: queryParams });
+    },
+});
+export const kagglePullKernel = tool({
+    description: "Tool to pull (download) the source code of a Kaggle kernel to local storage. Use when you need to retrieve a kernel's notebook, script, or metadata files. Optionally include metadata JSON file with kernel configuration details.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        path: z.string().optional().describe("Deprecated. Local download paths are no longer returned."),
+        force: z.boolean().optional().describe("Deprecated. Local file caching is no longer used."),
+        metadata: z.boolean().optional().describe("If true, include kernel-metadata.json file in the download. This file contains kernel configuration details like language, GPU settings, and dataset references."),
+        ownerSlug: z.string().describe("Kernel owner username (e.g., 'kami1976'). This is the username of the person or organization that owns the kernel."),
+        kernelSlug: z.string().describe("Kernel name/slug (e.g., 'stanford-rna-3d-enhanced-model'). This is the URL-friendly identifier for the kernel, typically lowercase with hyphens."),
+    }),
+    execute: async ({ kaggleCredentials, path, force, metadata, ownerSlug, kernelSlug }) => {
+        const queryParams = { userName: ownerSlug, kernelSlug: kernelSlug, metadata: metadata };
+        return kaggle(kaggleCredentials, { path: `/kernels/pull`, method: 'GET', query: queryParams });
+    },
+});
+//# sourceMappingURL=kernels.js.map

package/dist/toolkits/kaggle/tools/model_instance_files.d.ts

@@ -0,0 +1,11 @@
+export declare const kaggleListModelInstanceVersionFiles: import("ai").Tool<{
+    ownerSlug: string;
+    modelSlug: string;
+    framework: string;
+    variationSlug: string;
+    versionNumber: number;
+    pageToken?: string | undefined;
+    pageSize?: number | undefined;
+    kaggleCredentials?: string | undefined;
+}, any>;
+//# sourceMappingURL=model_instance_files.d.ts.map

package/dist/toolkits/kaggle/tools/model_instance_files.js

@@ -0,0 +1,23 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { kaggle } from './client.js';
+const tokenField = z.string().optional().describe('Injected by system; do not provide');
+export const kaggleListModelInstanceVersionFiles = tool({
+    description: "Tool to list files for a specific version of a model variation. Use when you need to retrieve files for a particular model framework instance version by owner, model, framework, variation, and version.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        framework: z.string().describe("Framework name (e.g., pyTorch, tensorFlow)."),
+        pageSize: z.number().int().optional().describe("Number of items per page (default: 20)."),
+        modelSlug: z.string().describe("Model name/slug."),
+        ownerSlug: z.string().describe("Model owner username."),
+        pageToken: z.string().optional().describe("Page token for results paging."),
+        variationSlug: z.string().describe("Variation name/slug (instance slug)."),
+        versionNumber: z.number().int().describe("Version number of the model variation."),
+    }),
+    execute: async ({ kaggleCredentials, framework, pageSize, modelSlug, ownerSlug, pageToken, variationSlug, versionNumber }) => {
+        const queryParams = { pageSize: pageSize, pageToken: pageToken };
+        return kaggle(kaggleCredentials, { path: `/models/${encodeURIComponent(ownerSlug)}/${encodeURIComponent(modelSlug)}/${encodeURIComponent(framework)}/${encodeURIComponent(variationSlug)}/${encodeURIComponent(versionNumber)}/files`, method: 'GET', query: queryParams });
+    },
+});
+//# sourceMappingURL=model_instance_files.js.map

package/dist/toolkits/kaggle/tools/model_instances.d.ts

@@ -0,0 +1,8 @@
+export declare const kaggleGetModelInstance: import("ai").Tool<{
+    ownerSlug: string;
+    modelSlug: string;
+    framework: string;
+    variationSlug: string;
+    kaggleCredentials?: string | undefined;
+}, any>;
+//# sourceMappingURL=model_instances.d.ts.map

package/dist/toolkits/kaggle/tools/model_instances.js

@@ -0,0 +1,20 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { kaggle } from './client.js';
+const tokenField = z.string().optional().describe('Injected by system; do not provide');
+export const kaggleGetModelInstance = tool({
+    description: "Tool to get details for a specific Kaggle model instance (variation). Returns metadata including overview, usage instructions, download URL, version information, and license details. Use when you need to inspect or retrieve information about a specific model variation before downloading or using it.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        framework: z.string().describe("Framework name for this model variation (e.g., TensorFlow2, PyTorch, Jax, TfLite, TfJs, Coral)."),
+        modelSlug: z.string().describe("Model name/slug. This is the second part of the model identifier (e.g., 'bert' in 'tensorflow/bert')."),
+        ownerSlug: z.string().describe("Model owner username or organization name. This is the first part of the model identifier (e.g., 'tensorflow' in 'tensorflow/bert')."),
+        variationSlug: z.string().describe("Variation name/slug. This identifies the specific model instance or version (e.g., 'bert-en-uncased-l-12-h-768-a-12')."),
+    }),
+    execute: async ({ kaggleCredentials, framework, modelSlug, ownerSlug, variationSlug }) => {
+        const queryParams = undefined;
+        return kaggle(kaggleCredentials, { path: `/models/${encodeURIComponent(ownerSlug)}/${encodeURIComponent(modelSlug)}/${encodeURIComponent(framework)}/${encodeURIComponent(variationSlug)}`, method: 'GET', query: queryParams });
+    },
+});
+//# sourceMappingURL=model_instances.js.map

package/dist/toolkits/kaggle/tools/models.d.ts

@@ -0,0 +1,14 @@
+export declare const kaggleGetModel: import("ai").Tool<{
+    ownerSlug: string;
+    modelSlug: string;
+    kaggleCredentials?: string | undefined;
+}, any>;
+export declare const kaggleListModels: import("ai").Tool<{
+    pageToken?: string | undefined;
+    owner?: string | undefined;
+    search?: string | undefined;
+    pageSize?: number | undefined;
+    kaggleCredentials?: string | undefined;
+    sortBy?: "hotness" | "voteCount" | "downloadCount" | "notebookCount" | "publishTime" | "createTime" | "updateTime" | undefined;
+}, any>;
+//# sourceMappingURL=models.d.ts.map

package/dist/toolkits/kaggle/tools/models.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { kaggle } from './client.js';
+const tokenField = z.string().optional().describe('Injected by system; do not provide');
+export const kaggleGetModel = tool({
+    description: "Tool to get a Kaggle model's details including metadata and description. Use when you need information about a specific model on Kaggle.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        modelSlug: z.string().describe("Model name/slug. This is the second part of the model identifier (e.g., 'bert' in 'google/bert')."),
+        ownerSlug: z.string().describe("Model owner username or organization name. This is the first part of the model identifier (e.g., 'google' in 'google/bert')."),
+    }),
+    execute: async ({ kaggleCredentials, modelSlug, ownerSlug }) => {
+        const queryParams = undefined;
+        return kaggle(kaggleCredentials, { path: `/models/${encodeURIComponent(ownerSlug)}/${encodeURIComponent(modelSlug)}`, method: 'GET', query: queryParams });
+    },
+});
+export const kaggleListModels = tool({
+    description: "Tool to list Kaggle models with optional filters for owner, sorting, search, and pagination. Use to discover available models on Kaggle's platform.",
+    inputSchema: z.object({
+        kaggleCredentials: tokenField,
+        owner: z.string().optional().describe("Filter to display models by a specific user or organization. Use the owner's username or organization slug."),
+        search: z.string().optional().describe("Search terms to filter models by title, owner, or other text fields. Leave empty to return all models."),
+        sortBy: z.enum(["hotness", "downloadCount", "voteCount", "notebookCount", "publishTime", "createTime", "updateTime"]).optional().describe("Enum for valid model list sort options."),
+        pageSize: z.number().int().optional().describe("Number of models to return per page. Default: 20. Maximum: 100."),
+        pageToken: z.string().optional().describe("Page token for pagination. Use the 'nextPageToken' from a previous response to fetch the next page of results. Omit for the first page."),
+    }),
+    execute: async ({ kaggleCredentials, owner, search, sortBy, pageSize, pageToken }) => {
+        const queryParams = { owner: owner, search: search, sortBy: sortBy, pageSize: pageSize, pageToken: pageToken };
+        return kaggle(kaggleCredentials, { path: `/models/list`, method: 'GET', query: queryParams });
+    },
+});
+//# sourceMappingURL=models.js.map

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

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

package/dist/toolkits/nasa/icon.js

@@ -0,0 +1,56 @@
+const SVG = `<svg height="92" viewBox="0 0 110 92" width="110" xmlns="http://www.w3.org/2000/svg">
+<circle cx="50.049" cy="45" fill="#0b3d91" r="40.14"/>
+<g fill="#fff">
+<circle cx="47.679" cy="12.57" r=".45"/>
+<circle cx="52.299" cy="13.17" r=".45"/>
+<circle cx="58.359" cy="21.33" r=".45"/>
+<circle cx="25.119" cy="63.33" r=".45"/>
+<circle cx="26.289" cy="66.93" r=".45"/>
+<circle cx="20.709" cy="63.87" r=".337"/>
+<circle cx="39.009" cy="70.942" r=".338"/>
+<circle cx="67.711" cy="64.98" r=".337"/>
+<circle cx="76.052" cy="55.92" r=".338"/>
+<circle cx="35.169" cy="23.962" r=".337"/>
+<circle cx="44.349" cy="17.22" r=".337"/>
+<circle cx="43.352" cy="16.56" r=".337"/>
+<circle cx="42.452" cy="15.9" r=".337"/>
+<circle cx="36.609" cy="25.703" r=".337"/>
+<circle cx="50.131" cy="8.16" r=".337"/>
+<circle cx="52.352" cy="17.88" r=".337"/>
+<circle cx="48.849" cy="15.982" r=".337"/>
+<circle cx="42.849" cy="18.563" r=".337"/>
+<circle cx="69.309" cy="73.883" r=".337"/>
+<circle cx="24.549" cy="65.61" r=".338"/>
+<circle cx="48.009" cy="69.96" r=".338"/>
+<circle cx="31.531" cy="65.34" r=".338"/>
+<circle cx="34.449" cy="70.103" r=".338"/>
+<circle cx="55.929" cy="67.103" r=".337"/>
+<circle cx="67.771" cy="60.42" r=".337"/>
+<circle cx="76.749" cy="64.522" r=".337"/>
+<circle cx="79.809" cy="66.48" r=".337"/>
+<circle cx="80.312" cy="61.14" r=".337"/>
+<circle cx="35.671" cy="53.58" r=".337"/>
+<circle cx="35.799" cy="61.32" r=".45"/>
+<circle cx="38.499" cy="67.02" r=".45"/>
+<circle cx="70.839" cy="61.08" r=".45"/>
+<circle cx="82.479" cy="60.42" r=".45"/>
+<circle cx="76.719" cy="57.96" r=".45"/>
+<circle cx="70.839" cy="58.2" r=".45"/>
+<path d="M58.71 12.288l1.119-.107-1.117-.063c-.035-.216-.208-.385-.426-.413l-.107-1.114-.064 1.123c-.202.045-.357.214-.382.424l-1.144.104 1.152.062c.042.193.198.344.394.38l.104 1.148.061-1.146C58.507 12.651 58.671 12.492 58.71 12.288z"/>
+<path d="M39.824 24.746l1.119-.107-1.117-.063c-.034-.216-.208-.385-.426-.413l-.107-1.114-.063 1.123c-.203.045-.358.214-.383.424l-1.144.104 1.152.062c.042.193.198.344.394.38l.104 1.148.062-1.146C39.622 25.11 39.786 24.95 39.824 24.746z"/>
+<path d="M81.659 57.684l1.119-.107-1.117-.063c-.034-.216-.208-.385-.426-.413l-.107-1.114-.063 1.123c-.202.045-.357.214-.382.424l-1.144.104 1.152.062c.042.193.198.344.394.38l.104 1.148.062-1.146C81.456 58.048 81.62 57.889 81.659 57.684z"/>
+<path d="M36.044 74.906l1.119-.107-1.117-.063c-.035-.216-.208-.385-.426-.413l-.107-1.113-.063 1.122c-.203.045-.358.214-.383.424l-1.144.104 1.152.062c.042.193.198.345.394.38l.104 1.148.062-1.146C35.841 75.27 36.006 75.11 36.044 74.906z"/>
+<path d="M78.104 66.506l1.119-.107-1.117-.063c-.034-.216-.208-.385-.426-.413l-.107-1.114-.063 1.122c-.202.045-.357.214-.382.424l-1.144.104 1.152.062c.042.193.198.344.394.38l.104 1.148.062-1.146C77.901 66.87 78.066 66.71 78.104 66.506z"/>
+<path d="M59.568 35.385c-4.667 1.814-9.219 3.433-13.06 4.635-7.805 2.444-29.16 9.06-42.06 17.4l1.08.42c7.86-4.44 12.969-5.835 17.88-7.38 5.34-1.68 22.603-5.72 30.42-7.92 2.641-.743 5.734-1.716 9.01-2.9-.762-1.063-1.566-2.129-2.412-3.193C60.143 36.088 59.856 35.734 59.568 35.385zM65.27 43.244c-1.13.763-2.077 1.372-2.74 1.756-3.84 2.22-22.561 15-26.82 17.94s-16.08 14.1-19.56 17.34l-.12 1.319c11.22-10.08 14.74-12.566 19.2-15.959 5.52-4.2 16.939-11.97 20.82-14.46 3.71-2.38 7.056-4.569 10.059-6.572-.049-.082-.098-.164-.147-.247C65.736 43.99 65.505 43.618 65.27 43.244zM82.809 24.72c-5.466 3.204-14.081 7.071-22.439 10.352.2.245.399.492.597.741.934 1.176 1.815 2.36 2.644 3.545 6.57-2.42 13.779-5.668 19.499-9.599-2.725 2.582-11.734 9.315-17.227 13.068.283.461.557.922.822 1.381 8.322-5.569 13.922-9.668 17.185-12.409 4.5-3.78 14.76-12.24 18.66-23.58C95.709 16.92 87.621 21.899 82.809 24.72z" fill="#fc3d21"/>
+<path d="M44.884 54.939c-.885-1.114-2.109-2.606-3.028-3.763-1.229-1.547-2.366-3.11-3.408-4.671-.34.085-.679.17-1.018.255 1.258 1.963 2.655 3.923 4.177 5.839 1.112 1.4 2.123 2.527 2.641 3.228.105.142.313.456.594.874.324-.22.651-.442.981-.666C45.504 55.688 45.189 55.323 44.884 54.939zM51.344 60.803c-.727-.688-2.49-1.837-4.325-3.561-.405.278-.814.56-1.224.844 1.185 1.67 2.799 3.721 4.063 4.319C51.762 63.307 52.275 61.685 51.344 60.803zM60.967 35.813c-10.492-13.206-23.309-20.461-28.835-16.07-4.292 3.41-2.53 13.376 3.386 23.845.306-.105.609-.208.909-.31-5.971-10.2-7.605-19.679-3.557-22.896 5.087-4.042 17.37 3.241 27.558 16.064 2.109 2.654 3.963 5.318 5.533 7.915 6.012 9.95 7.857 18.948 3.703 22.621-1.271 1.124-5.155 1.565-10.243-.725-.071.089.043.33.132.389 4.392 1.766 8.599 2.439 10.723.752C75.38 63.342 71.459 49.019 60.967 35.813z"/>
+<path d="M15.969 37.38h6.72l5.64 9.57c0 0 0-6.93 0-7.47 0-.84-1.065-1.935-1.44-2.1.45 0 4.38 0 4.65 0-.285.075-1.2 1.185-1.2 2.1 0 .45 0 10.5 0 10.98 0 .675.975 1.605 1.44 1.965h-6.48l-5.73-9.615c0 0 0 7.17 0 7.56 0 .75.735 1.47 1.5 2.085h-4.95c.705-.3 1.38-1.245 1.44-1.995s0-10.425 0-10.845C17.559 38.7 16.674 37.95 15.969 37.38z"/>
+<path d="M77.439 52.425h8.94c-.495-.12-1.05-.705-1.35-1.485-.3-.78-5.04-13.56-5.04-13.56H76.59c-.964.694-1.997 1.426-3.1 2.197-.003.028-.006.056-.011.083-.148.9-2.808 10.534-2.97 11.01-.225.66-1.38 1.395-1.845 1.785h4.815c-.48-.54-.87-1.065-.78-1.665.09-.6.36-1.8.36-1.8h4.98c.225.6.393 1.139.48 1.65C78.624 51.255 77.994 51.945 77.439 52.425zM73.509 47.07l1.68-5.49 2.22 5.49H73.509zM72.752 37.928c.247-.182.495-.365.742-.548h-1.305C72.319 37.5 72.534 37.689 72.752 37.928z"/>
+<path d="M38.559 50.79c.09-.6.36-1.8.36-1.8h4.98c.225.6.393 1.139.48 1.65.105.615-.525 1.305-1.08 1.785h7.871c.164-.11.327-.22.49-.329-.305-.27-.586-.675-.771-1.156-.3-.78-5.04-13.56-5.04-13.56h-7.8c.375.345 1.455 1.275 1.29 2.28-.147.9-2.808 10.534-2.97 11.01-.225.66-1.38 1.395-1.845 1.785h4.815C38.859 51.915 38.469 51.39 38.559 50.79zM41.049 41.58l2.22 5.49h-3.9L41.049 41.58z"/>
+<path d="M65.748 44.848c-1.468.978-3.017 1.999-4.649 3.065.732.355 1.315.801 1.371 1.377.104 1.082-2.07 1.605-4.035 1.38-.393-.045-.779-.148-1.147-.286-.408.263-.82.528-1.238.796-.425.273-.941.609-1.53.997v1.553c.39-.765 1.243-1.45 1.905-1.485.285-.015 1.275.9 5.355.675 1.98-.109 5.805-2.22 5.745-4.65C67.489 46.834 66.739 45.714 65.748 44.848zM54.519 48.6v1.582c.361-.241.717-.478 1.066-.709C55.036 49.091 54.647 48.734 54.519 48.6zM64.353 43.855c-.38-.225-.765-.422-1.134-.596-1.92-.9-3.93-1.065-4.35-2.28-.296-.857.54-1.65 2.58-1.62 2.04.03 3.93 1.245 4.44 1.68v-3.87c-.15.15-.808.905-1.41.78-1.155-.24-3.12-.553-5.37-.54-2.58.015-4.8 2.009-4.875 4.53-.105 3.525 2.715 4.485 4.305 5.04.164.057.351.118.554.183 1.525-.992 2.731-1.756 3.437-2.163C63.004 44.726 63.625 44.334 64.353 43.855z"/>
+</g>
+</svg>`;
+export const NASA_ICON = {
+    kind: 'svg',
+    dataUri: `data:image/svg+xml;base64,${Buffer.from(SVG).toString('base64')}`,
+};
+//# sourceMappingURL=icon.js.map

package/dist/toolkits/nasa/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/nasa/manifest.js

@@ -0,0 +1,49 @@
+import { defineToolkit, defineTool } from '../../core/define.js';
+import { NASA_ICON } from './icon.js';
+import { nasaTools } from './tools/index.js';
+export default defineToolkit({
+    id: 'nasa',
+    displayName: 'NASA',
+    shortDescription: 'Asteroids, APOD, space weather, Earth imagery, science datasets, and publications.',
+    category: 'Analytics & Data',
+    icon: NASA_ICON,
+    auth: {
+        type: 'api_key',
+        tokenField: 'nasaApiKey',
+        provider: {
+            in: 'query',
+            name: 'api_key',
+            connectDescription: 'Connect NASA with an api.nasa.gov API key (get a free key at https://api.nasa.gov). The key is sent as the api_key query parameter on api.nasa.gov endpoints (NeoWs, APOD, DONKI, Mars photos, EPIC, TechPort). All other NASA services in this toolkit (EONET, CMR, NTRS, OSDR, SSC, POWER, OpenAltimetry, image library, AGAGE, TOLNet, SVS) are keyless and need no connection.',
+        },
+    },
+    allowedHosts: [
+        'api.nasa.gov',
+        'exoplanetarchive.ipac.caltech.edu',
+        'eonet.gsfc.nasa.gov',
+        'cmr.earthdata.nasa.gov',
+        'graphql.earthdata.nasa.gov',
+        'ntrs.nasa.gov',
+        'osdr.nasa.gov',
+        'sscweb.gsfc.nasa.gov',
+        'power.larc.nasa.gov',
+        'openaltimetry.earthdatacloud.nasa.gov',
+        'images-api.nasa.gov',
+        'svs.gsfc.nasa.gov',
+        'www-air.larc.nasa.gov',
+        'tolnet.larc.nasa.gov',
+    ],
+    tools: nasaTools.map((entry) => defineTool({
+        name: entry.name,
+        description: entry.description,
+        tool: entry.tool,
+        requiredAuth: entry.requiredAuth,
+        scope: entry.scope,
+    })),
+    meta: {
+        since: '0.0.10',
+        homepage: 'https://api.nasa.gov',
+        docsUrl: 'https://api.nasa.gov',
+        apiDocsUrl: 'https://api.nasa.gov',
+    },
+});
+//# sourceMappingURL=manifest.js.map

package/dist/toolkits/nasa/tools/agage.d.ts

@@ -0,0 +1,60 @@
+export declare const nasaGetAgageData: import("ai").Tool<{
+    version?: string | undefined;
+    page?: number | undefined;
+    order?: string | undefined;
+    nasaApiKey?: string | undefined;
+    instrument?: string | undefined;
+    station?: string | undefined;
+    compound?: string | undefined;
+    maxDate?: string | undefined;
+    minDate?: string | undefined;
+    recommended?: boolean | undefined;
+    productType?: string | undefined;
+    dataFrequency?: string | undefined;
+    orderDirection?: string | undefined;
+}, any>;
+export declare const nasaGetAgageDataByFileName: import("ai").Tool<{
+    fileName: string;
+    nasaApiKey?: string | undefined;
+    matchType?: "exact_match" | "begins_with" | "ends_with" | undefined;
+}, any>;
+export declare const nasaGetAgageDataJsonForGraph: import("ai").Tool<{
+    id: number;
+    nasaApiKey?: string | undefined;
+}, any>;
+export declare const nasaGetAgageDataDownload: import("ai").Tool<{
+    ids: string;
+    nasaApiKey?: string | undefined;
+}, {
+    error: string;
+    details: unknown;
+    statusCode: number;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    statusCode?: undefined;
+} | {
+    name: string;
+    mimetype: string | null;
+    sizeBytes: number | null;
+    url: string;
+    note: string;
+}>;
+export declare const nasaGetAgageDataVersions: import("ai").Tool<{
+    nasaApiKey?: string | undefined;
+}, any>;
+export declare const nasaGetCompounds: import("ai").Tool<{
+    nasaApiKey?: string | undefined;
+}, any>;
+export declare const nasaGetStations: import("ai").Tool<{
+    nasaApiKey?: string | undefined;
+}, any>;
+export declare const nasaGetDataFrequencies: import("ai").Tool<{
+    nasaApiKey?: string | undefined;
+}, any>;
+export declare const nasaGetProcessingTypes: import("ai").Tool<{
+    nasaApiKey?: string | undefined;
+}, any>;
+//# sourceMappingURL=agage.d.ts.map

package/dist/toolkits/nasa/tools/agage.js

@@ -0,0 +1,176 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { nasaGet, nasaDownloadMeta, toNasaError, enc } from './client.js';
+export const nasaGetAgageData = tool({
+    description: "Tool to retrieve information about AGAGE (Advanced Global Atmospheric Gases Experiment) data files. Returns paginated results (40 files per page) with detailed metadata including compound names, stations, dates, instruments, and file locations. Use when you need to search or browse AGAGE atmospheric data files. Supports filtering by recommendation status, compounds, stations, date ranges, and other criteria.",
+    inputSchema: z.object({
+        nasaApiKey: z.string().optional().describe("NASA API key (injected when connected; only sent to api.nasa.gov endpoints)"),
+        page: z.number().int().min(1).optional().describe("Page number for paginated results. Each page returns 40 data files. Must be 1 or greater."),
+        order: z.string().optional().describe("Primary sort order for results. Valid values: 'compound_display_order', 'station_display_order', 'data_date', 'upload_date', 'compound_name', 'file_name', 'product_type_name', 'data_frequency_name', 'instrument_names', 'station_name', 'version_name'. Secondary sort is always by station display_order. Defaults to 'compound_display_order'."),
+        station: z.string().optional().describe("One or more comma-separated station IDs to filter by (e.g., '16')."),
+        version: z.string().optional().describe("One or more comma-separated version IDs to filter by (e.g., '1')."),
+        compound: z.string().optional().describe("One or more comma-separated compound IDs to filter by (e.g., '14' or '14,15,16')."),
+        maxDate: z.string().optional().describe("Exclude all data after this date. Format: YYYY-MM-DD (e.g., '2030-05-01')."),
+        minDate: z.string().optional().describe("Exclude all data before this date. Format: YYYY-MM-DD (e.g., '2021-05-01')."),
+        instrument: z.string().optional().describe("One or more comma-separated instrument IDs to filter by (e.g., '6')."),
+        recommended: z.boolean().optional().describe("Filter by recommendation status. If true, returns only files recommended by the AGAGE team. If false, returns non-recommended files. If omitted, returns all files regardless of recommendation status."),
+        productType: z.string().optional().describe("One or more comma-separated product type IDs to filter by (e.g., '1' or '1,2')."),
+        dataFrequency: z.string().optional().describe("One or more comma-separated data frequency IDs to filter by (e.g., '1')."),
+        orderDirection: z.string().optional().describe("Sort direction for the order parameter. Valid values: 'asc' (ascending) or 'desc' (descending). Defaults to 'desc'."),
+    }),
+    execute: async ({ nasaApiKey, page, order, station, version, compound, maxDate, minDate, instrument, recommended, productType, dataFrequency, orderDirection }) => {
+        try {
+            const query = {};
+            if (compound !== undefined)
+                query["compound"] = compound;
+            if (productType !== undefined)
+                query["product_type"] = productType;
+            if (dataFrequency !== undefined)
+                query["data_frequency"] = dataFrequency;
+            if (instrument !== undefined)
+                query["instrument"] = instrument;
+            if (version !== undefined)
+                query["version"] = version;
+            if (station !== undefined)
+                query["station"] = station;
+            if (minDate !== undefined)
+                query["min_date"] = minDate;
+            if (maxDate !== undefined)
+                query["max_date"] = maxDate;
+            if (recommended !== undefined)
+                query["recommended"] = recommended;
+            if (order !== undefined)
+                query["order"] = order;
+            if (orderDirection !== undefined)
+                query["order_direction"] = orderDirection;
+            return await nasaGet("https://www-air.larc.nasa.gov/missions/agage/api", `/data/${page ?? 1}`, { query });
+        }
+        catch (error) {
+            return toNasaError(error, "Failed to get agage data");
+        }
+    },
+});
+export const nasaGetAgageDataByFileName = tool({
+    description: "Search for AGAGE (Advanced Global Atmospheric Gases Experiment) data files by file name. Returns detailed metadata about matching files including compound information, station details, temporal coverage, geographic coordinates, and file properties. Use this when you need to find specific AGAGE data files or retrieve metadata about atmospheric gas measurements.",
+    inputSchema: z.object({
+        nasaApiKey: z.string().optional().describe("NASA API key (injected when connected; only sent to api.nasa.gov endpoints)"),
+        fileName: z.string().describe("The name of the file to search for. Can be a full filename (e.g., 'agage_adr_ch3ccl3_git-baseline-20250123.nc') or a partial name depending on match_type."),
+        matchType: z.enum(["exact_match", "begins_with", "ends_with"]).optional().describe("Match type for file name search."),
+    }),
+    execute: async ({ nasaApiKey, fileName, matchType }) => {
+        try {
+            const query = {};
+            if (fileName !== undefined)
+                query["file_name"] = fileName;
+            if (matchType !== undefined)
+                query["match_type"] = matchType;
+            return await nasaGet("https://www-air.larc.nasa.gov/missions/agage/api", `/data/search_by_file_name`, { query });
+        }
+        catch (error) {
+            return toNasaError(error, "Failed to get agage data by file name");
+        }
+    },
+});
+export const nasaGetAgageDataJsonForGraph = tool({
+    description: "Retrieve AGAGE atmospheric composition data in JSON format optimized for graphing. Returns time series data including O3_Number_Density and other trace gas measurements with start/stop dates. Use this when you need to visualize or analyze atmospheric composition trends from NASA's Advanced Global Atmospheric Gases Experiment (AGAGE) network.",
+    inputSchema: z.object({
+        nasaApiKey: z.string().optional().describe("NASA API key (injected when connected; only sent to api.nasa.gov endpoints)"),
+        id: z.number().int().min(1).describe("Data ID associated with one hi-res AGAGE file. Use this to retrieve specific atmospheric composition measurements."),
+    }),
+    execute: async ({ nasaApiKey, id }) => {
+        try {
+            return await nasaGet("https://www-air.larc.nasa.gov/missions/agage/api", `/data/json_for_graph/${enc(id)}`);
+        }
+        catch (error) {
+            return toNasaError(error, "Failed to get agage data json for graph");
+        }
+    },
+});
+export const nasaGetAgageDataDownload = tool({
+    description: "Download AGAGE (Advanced Global Atmospheric Gases Experiment) data files by ID. Accepts up to 35 comma-separated data IDs in a single request. Returns the requested data file(s) as a downloadable binary file. Use this when you need to retrieve specific AGAGE atmospheric measurement datasets.",
+    inputSchema: z.object({
+        nasaApiKey: z.string().optional().describe("NASA API key (injected when connected; only sent to api.nasa.gov endpoints)"),
+        ids: z.string().describe("A comma-delimited list of data IDs to download (e.g., '1127' or '1127,1128,1129'). Maximum 35 IDs per request. Each ID corresponds to a specific AGAGE dataset file."),
+    }),
+    execute: async ({ nasaApiKey, ids }) => {
+        try {
+            const headers = {};
+            return await nasaDownloadMeta("https://www-air.larc.nasa.gov/missions/agage/api", `/data/download/${enc(ids)}`, headers);
+        }
+        catch (error) {
+            return toNasaError(error, "Failed to get agage data download");
+        }
+    },
+});
+export const nasaGetAgageDataVersions = tool({
+    description: "Tool to retrieve information on all AGAGE (Advanced Global Atmospheric Gases Experiment) data versions. Use when you need version details, DOIs, citations, or descriptions for the NASA AGAGE dataset archive.",
+    inputSchema: z.object({
+        nasaApiKey: z.string().optional().describe("NASA API key (injected when connected; only sent to api.nasa.gov endpoints)"),
+    }),
+    execute: async ({ nasaApiKey }) => {
+        try {
+            return await nasaGet("https://www-air.larc.nasa.gov/missions/agage/api", `/data/versions`);
+        }
+        catch (error) {
+            return toNasaError(error, "Failed to get agage data versions");
+        }
+    },
+});
+export const nasaGetCompounds = tool({
+    description: "Tool to retrieve information on all data compounds available in NASA's AGAGE (Advanced Global Atmospheric Gases Experiment) API. Use when you need to discover available chemical compounds, their identifiers, and descriptions.",
+    inputSchema: z.object({
+        nasaApiKey: z.string().optional().describe("NASA API key (injected when connected; only sent to api.nasa.gov endpoints)"),
+    }),
+    execute: async ({ nasaApiKey }) => {
+        try {
+            return await nasaGet("https://www-air.larc.nasa.gov/missions/agage/api", `/data/compounds`);
+        }
+        catch (error) {
+            return toNasaError(error, "Failed to get compounds");
+        }
+    },
+});
+export const nasaGetStations = tool({
+    description: "Tool to retrieve information on all AGAGE (Advanced Global Atmospheric Gases Experiment) data stations. Use when you need station names, locations, coordinates, elevation, or other metadata about monitoring sites.",
+    inputSchema: z.object({
+        nasaApiKey: z.string().optional().describe("NASA API key (injected when connected; only sent to api.nasa.gov endpoints)"),
+    }),
+    execute: async ({ nasaApiKey }) => {
+        try {
+            return await nasaGet("https://www-air.larc.nasa.gov/missions/agage/api", `/data/stations`);
+        }
+        catch (error) {
+            return toNasaError(error, "Failed to get stations");
+        }
+    },
+});
+export const nasaGetDataFrequencies = tool({
+    description: "Retrieves all available data frequency options from NASA's AGAGE (Advanced Global Atmospheric Gases Experiment) mission. Data frequencies define the measurement intervals for atmospheric data collection (e.g., hourly, daily). Use this tool to: - Discover available measurement frequencies for AGAGE data - Get frequency IDs for filtering atmospheric gas data by sampling rate - Understand what each frequency option represents No parameters required - returns all available data frequencies.",
+    inputSchema: z.object({
+        nasaApiKey: z.string().optional().describe("NASA API key (injected when connected; only sent to api.nasa.gov endpoints)"),
+    }),
+    execute: async ({ nasaApiKey }) => {
+        try {
+            return await nasaGet("https://www-air.larc.nasa.gov/missions/agage/api", `/data/data_frequencies`);
+        }
+        catch (error) {
+            return toNasaError(error, "Failed to get data frequencies");
+        }
+    },
+});
+export const nasaGetProcessingTypes = tool({
+    description: "Tool to retrieve information on all data instruments from NASA's AGAGE mission. Use when you need to list available instruments with their IDs, names, and descriptions.",
+    inputSchema: z.object({
+        nasaApiKey: z.string().optional().describe("NASA API key (injected when connected; only sent to api.nasa.gov endpoints)"),
+    }),
+    execute: async ({ nasaApiKey }) => {
+        try {
+            return await nasaGet("https://www-air.larc.nasa.gov/missions/agage/api", `/data/instruments`);
+        }
+        catch (error) {
+            return toNasaError(error, "Failed to get processing types");
+        }
+    },
+});
+//# sourceMappingURL=agage.js.map