@hasna/skills 0.1.26 → 0.1.29

package/skills/deepresearch/src/services/exa.ts

@@ -1,108 +0,0 @@
-import Exa from "exa-js";
-import type { ExaSearchResponse, Source } from "../types";
-import logger from "../utils/logger";
-
-const EXA_CONCURRENT_LIMIT = 5;
-
-let client: Exa | null = null;
-
-function getClient(): Exa {
-  if (!client) {
-    const apiKey = process.env.EXA_API_KEY;
-    if (!apiKey) {
-      throw new Error(
-        "EXA_API_KEY not found. Please set it in ~/.secrets or environment."
-      );
-    }
-    client = new Exa(apiKey);
-  }
-  return client;
-}
-
-export async function searchWithContent(
-  query: string,
-  numResults: number = 5
-): Promise<ExaSearchResponse> {
-  const exa = getClient();
-
-  const response = await exa.searchAndContents(query, {
-    type: "neural",
-    useAutoprompt: true,
-    numResults,
-    text: {
-      maxCharacters: 3000,
-      includeHtmlTags: false,
-    },
-    highlights: {
-      numSentences: 3,
-      highlightsPerUrl: 3,
-    },
-  });
-
-  return {
-    results: response.results.map((r) => ({
-      title: r.title || "Untitled",
-      url: r.url,
-      publishedDate: r.publishedDate,
-      author: r.author,
-      score: r.score,
-      text: r.text,
-      highlights: r.highlights,
-      highlightScores: r.highlightScores,
-    })),
-    autopromptString: response.autopromptString,
-  };
-}
-
-export async function searchInBatches(
-  queries: string[],
-  resultsPerQuery: number = 5
-): Promise<Source[]> {
-  const allSources: Source[] = [];
-  const seenUrls = new Set<string>();
-  let sourceId = 1;
-
-  for (let i = 0; i < queries.length; i += EXA_CONCURRENT_LIMIT) {
-    const batch = queries.slice(i, i + EXA_CONCURRENT_LIMIT);
-    const batchNum = Math.floor(i / EXA_CONCURRENT_LIMIT) + 1;
-    const totalBatches = Math.ceil(queries.length / EXA_CONCURRENT_LIMIT);
-
-    logger.updateSpinner(
-      `Searching batch ${batchNum}/${totalBatches} (${batch.length} queries)...`
-    );
-
-    const batchResults = await Promise.all(
-      batch.map(async (query) => {
-        try {
-          return await searchWithContent(query, resultsPerQuery);
-        } catch (error) {
-          logger.warn(`Search failed for query: "${query.slice(0, 50)}..."`);
-          return { results: [] };
-        }
-      })
-    );
-
-    for (const response of batchResults) {
-      for (const result of response.results) {
-        if (!seenUrls.has(result.url) && result.text) {
-          seenUrls.add(result.url);
-          allSources.push({
-            id: sourceId++,
-            title: result.title,
-            url: result.url,
-            content: result.text,
-            publishedDate: result.publishedDate,
-            author: result.author,
-            relevanceScore: result.score,
-          });
-        }
-      }
-    }
-  }
-
-  return allSources;
-}
-
-export function isExaConfigured(): boolean {
-  return !!process.env.EXA_API_KEY;
-}

package/skills/deepresearch/src/services/firecrawl.ts

@@ -1,88 +0,0 @@
-import type { FirecrawlResult } from "../types";
-
-const FIRECRAWL_API_URL = "https://api.firecrawl.dev/v1/scrape";
-
-export async function scrapeUrl(url: string): Promise<FirecrawlResult> {
-  const apiKey = process.env.FIRECRAWL_API_KEY;
-  if (!apiKey) {
-    return {
-      url,
-      markdown: "",
-      success: false,
-      error: "FIRECRAWL_API_KEY not configured",
-    };
-  }
-
-  try {
-    const response = await fetch(FIRECRAWL_API_URL, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${apiKey}`,
-      },
-      body: JSON.stringify({
-        url,
-        formats: ["markdown"],
-        onlyMainContent: true,
-        waitFor: 2000,
-      }),
-    });
-
-    if (!response.ok) {
-      const error = await response.text();
-      return {
-        url,
-        markdown: "",
-        success: false,
-        error: `HTTP ${response.status}: ${error}`,
-      };
-    }
-
-    const data = (await response.json()) as {
-      success: boolean;
-      data?: { markdown?: string };
-      error?: string;
-    };
-
-    if (!data.success) {
-      return {
-        url,
-        markdown: "",
-        success: false,
-        error: data.error || "Unknown error",
-      };
-    }
-
-    return {
-      url,
-      markdown: data.data?.markdown || "",
-      success: true,
-    };
-  } catch (error) {
-    return {
-      url,
-      markdown: "",
-      success: false,
-      error: error instanceof Error ? error.message : "Unknown error",
-    };
-  }
-}
-
-export async function scrapeUrls(
-  urls: string[],
-  concurrentLimit: number = 3
-): Promise<FirecrawlResult[]> {
-  const results: FirecrawlResult[] = [];
-
-  for (let i = 0; i < urls.length; i += concurrentLimit) {
-    const batch = urls.slice(i, i + concurrentLimit);
-    const batchResults = await Promise.all(batch.map((url) => scrapeUrl(url)));
-    results.push(...batchResults);
-  }
-
-  return results;
-}
-
-export function isFirecrawlConfigured(): boolean {
-  return !!process.env.FIRECRAWL_API_KEY;
-}

package/skills/deepresearch/src/services/openai.ts

@@ -1,81 +0,0 @@
-import OpenAI from "openai";
-
-let client: OpenAI | null = null;
-
-function getClient(): OpenAI {
-  if (!client) {
-    const apiKey = process.env.OPENAI_API_KEY;
-    if (!apiKey) {
-      throw new Error(
-        "OPENAI_API_KEY not found. Please set it in ~/.secrets or environment."
-      );
-    }
-    client = new OpenAI({ apiKey });
-  }
-  return client;
-}
-
-export async function generateText(
-  systemPrompt: string,
-  userPrompt: string,
-  options?: {
-    maxTokens?: number;
-    temperature?: number;
-  }
-): Promise<string> {
-  const openai = getClient();
-
-  const response = await openai.chat.completions.create({
-    model: "gpt-4o",
-    max_tokens: options?.maxTokens || 8192,
-    temperature: options?.temperature ?? 0.7,
-    messages: [
-      { role: "system", content: systemPrompt },
-      { role: "user", content: userPrompt },
-    ],
-  });
-
-  const content = response.choices[0]?.message?.content;
-  if (!content) {
-    throw new Error("No response from OpenAI");
-  }
-
-  return content;
-}
-
-export async function generateJson<T>(
-  systemPrompt: string,
-  userPrompt: string,
-  options?: {
-    maxTokens?: number;
-    temperature?: number;
-  }
-): Promise<T> {
-  const openai = getClient();
-
-  const response = await openai.chat.completions.create({
-    model: "gpt-4o",
-    max_tokens: options?.maxTokens || 8192,
-    temperature: options?.temperature ?? 0.3,
-    response_format: { type: "json_object" },
-    messages: [
-      { role: "system", content: systemPrompt + "\n\nRespond with valid JSON only." },
-      { role: "user", content: userPrompt },
-    ],
-  });
-
-  const content = response.choices[0]?.message?.content;
-  if (!content) {
-    throw new Error("No response from OpenAI");
-  }
-
-  try {
-    return JSON.parse(content) as T;
-  } catch {
-    throw new Error(`Failed to parse JSON from OpenAI response: ${content.slice(0, 200)}`);
-  }
-}
-
-export function isOpenAIConfigured(): boolean {
-  return !!process.env.OPENAI_API_KEY;
-}

package/skills/deepresearch/src/types.ts

@@ -1,76 +0,0 @@
-export type DepthLevel = "quick" | "normal" | "deep";
-export type ModelProvider = "claude" | "openai";
-
-export interface ResearchConfig {
-  topic: string;
-  depth: DepthLevel;
-  model: ModelProvider;
-  output?: string;
-  json?: boolean;
-  firecrawl?: boolean;
-}
-
-export interface DepthSettings {
-  queryCount: number;
-  iterations: number;
-  resultsPerQuery: number;
-}
-
-export const DEPTH_CONFIG: Record<DepthLevel, DepthSettings> = {
-  quick: { queryCount: 6, iterations: 1, resultsPerQuery: 3 },
-  normal: { queryCount: 15, iterations: 1, resultsPerQuery: 5 },
-  deep: { queryCount: 30, iterations: 2, resultsPerQuery: 5 },
-};
-
-export interface ExaSearchResult {
-  title: string;
-  url: string;
-  publishedDate?: string;
-  author?: string;
-  score?: number;
-  text?: string;
-  highlights?: string[];
-  highlightScores?: number[];
-}
-
-export interface ExaSearchResponse {
-  results: ExaSearchResult[];
-  autopromptString?: string;
-}
-
-export interface Source {
-  id: number;
-  title: string;
-  url: string;
-  content: string;
-  publishedDate?: string;
-  author?: string;
-  relevanceScore?: number;
-}
-
-export interface ResearchReport {
-  topic: string;
-  depth: DepthLevel;
-  generatedAt: string;
-  queryCount: number;
-  sourceCount: number;
-  report: string;
-  sources: Source[];
-}
-
-export interface QueryGenerationResult {
-  queries: string[];
-  reasoning?: string;
-}
-
-export interface SynthesisResult {
-  report: string;
-  summary?: string;
-}
-
-export interface FirecrawlResult {
-  url: string;
-  markdown: string;
-  success: boolean;
-  error?: string;
-}

package/skills/deepresearch/src/utils/file.ts

@@ -1,111 +0,0 @@
-import { mkdir, writeFile } from "fs/promises";
-import { join, dirname } from "path";
-import { homedir } from "os";
-import type { ResearchReport, Source } from "../types";
-
-const SKILL_DIR = join(homedir(), ".skills", "deepresearch");
-const EXPORTS_DIR = join(SKILL_DIR, "exports");
-const LOGS_DIR = join(SKILL_DIR, "logs");
-
-export async function ensureDir(dir: string): Promise<void> {
-  await mkdir(dir, { recursive: true });
-}
-
-export async function ensureSkillDirs(): Promise<void> {
-  await ensureDir(EXPORTS_DIR);
-  await ensureDir(LOGS_DIR);
-}
-
-function generateTimestamp(): string {
-  const now = new Date();
-  return now.toISOString().replace(/[:.]/g, "-").slice(0, 19);
-}
-
-function sanitizeFilename(topic: string): string {
-  return topic
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-|-$/g, "")
-    .slice(0, 50);
-}
-
-export async function saveReport(
-  report: ResearchReport,
-  customPath?: string
-): Promise<string> {
-  await ensureSkillDirs();
-
-  const timestamp = generateTimestamp();
-  const topicSlug = sanitizeFilename(report.topic);
-  const filename = `report-${topicSlug}-${timestamp}.md`;
-  const filepath = customPath || join(EXPORTS_DIR, filename);
-
-  if (customPath) {
-    await ensureDir(dirname(customPath));
-  }
-
-  const content = formatReport(report);
-  await writeFile(filepath, content, "utf-8");
-
-  return filepath;
-}
-
-export async function saveSourcesJson(
-  sources: Source[],
-  topic: string,
-  customPath?: string
-): Promise<string> {
-  await ensureSkillDirs();
-
-  const timestamp = generateTimestamp();
-  const topicSlug = sanitizeFilename(topic);
-  const filename = `sources-${topicSlug}-${timestamp}.json`;
-  const filepath = customPath
-    ? customPath.replace(/\.md$/, ".json")
-    : join(EXPORTS_DIR, filename);
-
-  if (customPath) {
-    await ensureDir(dirname(filepath));
-  }
-
-  await writeFile(filepath, JSON.stringify(sources, null, 2), "utf-8");
-
-  return filepath;
-}
-
-function formatReport(report: ResearchReport): string {
-  const header = `# Research Report: ${report.topic}
-
-**Generated:** ${report.generatedAt}
-**Depth:** ${report.depth}
-**Queries:** ${report.queryCount}
-**Sources:** ${report.sourceCount}
-
----
-
-`;
-
-  const sourcesSection = `
-
----
-
-## Sources
-
-${report.sources
-  .map(
-    (s) =>
-      `${s.id}. [${s.title}](${s.url})${s.publishedDate ? ` - ${s.publishedDate}` : ""}`
-  )
-  .join("\n")}
-`;
-
-  return header + report.report + sourcesSection;
-}
-
-export function getExportsDir(): string {
-  return EXPORTS_DIR;
-}
-
-export function getLogsDir(): string {
-  return LOGS_DIR;
-}

package/skills/deepresearch/src/utils/logger.ts

@@ -1,84 +0,0 @@
-import ora, { type Ora } from "ora";
-import chalk from "chalk";
-
-let spinner: Ora | null = null;
-
-export const logger = {
-  info(message: string) {
-    if (spinner?.isSpinning) spinner.stop();
-    console.log(chalk.blue("ℹ"), message);
-    if (spinner) spinner.start();
-  },
-
-  success(message: string) {
-    if (spinner?.isSpinning) spinner.stop();
-    console.log(chalk.green("✓"), message);
-  },
-
-  warn(message: string) {
-    if (spinner?.isSpinning) spinner.stop();
-    console.log(chalk.yellow("⚠"), message);
-    if (spinner) spinner.start();
-  },
-
-  error(message: string) {
-    if (spinner?.isSpinning) spinner.stop();
-    console.log(chalk.red("✗"), message);
-  },
-
-  step(step: number, total: number, message: string) {
-    if (spinner?.isSpinning) spinner.stop();
-    console.log(chalk.dim(`[${step}/${total}]`), message);
-  },
-
-  startSpinner(message: string): Ora {
-    spinner = ora({
-      text: message,
-      color: "cyan",
-    }).start();
-    return spinner;
-  },
-
-  updateSpinner(message: string) {
-    if (spinner) {
-      spinner.text = message;
-    }
-  },
-
-  succeedSpinner(message: string) {
-    if (spinner) {
-      spinner.succeed(message);
-      spinner = null;
-    }
-  },
-
-  failSpinner(message: string) {
-    if (spinner) {
-      spinner.fail(message);
-      spinner = null;
-    }
-  },
-
-  stopSpinner() {
-    if (spinner) {
-      spinner.stop();
-      spinner = null;
-    }
-  },
-
-  header(title: string) {
-    console.log();
-    console.log(chalk.bold.cyan(`═══ ${title} ═══`));
-    console.log();
-  },
-
-  divider() {
-    console.log(chalk.dim("─".repeat(50)));
-  },
-
-  stats(label: string, value: string | number) {
-    console.log(chalk.dim(`  ${label}:`), chalk.white(value));
-  },
-};
-
-export default logger;