Initial commit: RA-H Open Source Edition

Local-first knowledge management system with BYO API keys.

Features:
- 3-panel UI (Nodes | Focus | Helpers)
- SQLite + sqlite-vec for vector search
- Agent system (Easy/Hard mode orchestrators)
- Content extraction (YouTube, PDF, web)
- Integrate workflow for connection discovery
- Dimension system with auto-assignment

Tech stack:
- Next.js 15 + TypeScript + Tailwind CSS
- Anthropic (Claude) + OpenAI (GPT) via Vercel AI SDK

Setup:
  npm install && npm rebuild better-sqlite3
  scripts/dev/bootstrap-local.sh
  npm run dev

MIT License

src/hooks/useQuotaHandler.ts

@@ -0,0 +1,51 @@
+"use client";
+
+import { useCallback, useState } from 'react';
+
+interface QuotaError {
+  message: string;
+  tokensUsed?: number | null;
+  tokenLimit?: number | null;
+  costUsd?: number | null;
+}
+
+const messageIncludesQuota = (message?: string) => {
+  if (!message) return false;
+  const normalized = message.toLowerCase();
+  return normalized.includes('quota') || normalized.includes('limit');
+};
+
+export function useQuotaHandler() {
+  const [quotaError, setQuotaError] = useState<QuotaError | null>(null);
+
+  const handleAPIError = useCallback((error: unknown, response?: Response) => {
+    const message =
+      error instanceof Error ? error.message : typeof error === 'string' ? error : undefined;
+
+    if (response?.status === 429 || messageIncludesQuota(message)) {
+      setQuotaError({
+        message: message || 'Rate limit reached. Please wait and try again.',
+      });
+      return true;
+    }
+
+    return false;
+  }, []);
+
+  const dismissQuotaError = useCallback(() => {
+    setQuotaError(null);
+  }, []);
+
+  const checkQuotaBeforeRequest = useCallback(() => true, []);
+
+  const refetchUsage = useCallback(async () => {}, []);
+
+  return {
+    quotaError,
+    handleAPIError,
+    checkQuotaBeforeRequest,
+    dismissQuotaError,
+    refetchUsage,
+    isQuotaExceeded: false,
+  };
+}