ralph-starter 0.0.1 → 0.1.1-beta.1

package/dist/integrations/notion/source.js

@@ -0,0 +1,463 @@
+/**
+ * Notion Integration Source
+ *
+ * Fetches pages from Notion:
+ * - Public pages: HTML fetch (no auth needed)
+ * - Private pages: Notion API (requires token)
+ */
+import { BaseIntegration, } from '../base.js';
+export class NotionIntegration extends BaseIntegration {
+    name = 'notion';
+    displayName = 'Notion';
+    description = 'Fetch pages from Notion (public or private)';
+    website = 'https://notion.so';
+    // Public pages don't need auth, private pages need API token
+    authMethods = ['none', 'api-key'];
+    API_BASE = 'https://api.notion.com/v1';
+    API_VERSION = '2022-06-28';
+    async fetch(identifier, options) {
+        // Check if it's a Notion URL
+        if (this.isNotionUrl(identifier)) {
+            // Try public HTML fetch first
+            const publicResult = await this.fetchPublicPage(identifier);
+            if (publicResult) {
+                return publicResult;
+            }
+            // Fall back to API if we have a token
+            if (await this.hasApiKey()) {
+                return this.fetchViaApi(identifier, options);
+            }
+            this.error('Could not fetch Notion page. If this is a private page, configure API token:\n' +
+                'ralph-starter config set notion.token <token>');
+        }
+        // Not a URL - try API search or direct ID
+        if (await this.hasApiKey()) {
+            return this.fetchViaApi(identifier, options);
+        }
+        this.error('Please provide a Notion URL or configure API token:\n' +
+            'ralph-starter config set notion.token <token>');
+    }
+    isNotionUrl(str) {
+        return str.includes('notion.so') || str.includes('notion.site');
+    }
+    /**
+     * Fetch a public Notion page via HTML
+     * Returns null if the page is not public
+     */
+    async fetchPublicPage(url) {
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'User-Agent': 'ralph-starter/0.1.0',
+                    Accept: 'text/html',
+                },
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const html = await response.text();
+            // Check if page requires login
+            if (html.includes('notion.so/login') || html.includes('Sign in')) {
+                return null;
+            }
+            // Extract content from HTML
+            const content = this.htmlToMarkdown(html);
+            const title = this.extractTitle(html);
+            return {
+                content: `# ${title}\n\n${content}`,
+                source: `notion:${url}`,
+                title,
+                metadata: {
+                    type: 'notion',
+                    method: 'html',
+                    url,
+                },
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Convert Notion HTML to markdown
+     */
+    htmlToMarkdown(html) {
+        // Extract main content area
+        let content = html;
+        // Try to find the main content div
+        const contentMatch = html.match(/<div[^>]*class="[^"]*notion-page-content[^"]*"[^>]*>([\s\S]*?)<\/div>/i);
+        if (contentMatch) {
+            content = contentMatch[1];
+        }
+        // Basic HTML to Markdown conversion
+        content = content
+            // Headings
+            .replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, '\n# $1\n')
+            .replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, '\n## $1\n')
+            .replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, '\n### $1\n')
+            // Paragraphs
+            .replace(/<p[^>]*>([\s\S]*?)<\/p>/gi, '\n$1\n')
+            // Lists
+            .replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, '- $1\n')
+            .replace(/<ul[^>]*>|<\/ul>/gi, '\n')
+            .replace(/<ol[^>]*>|<\/ol>/gi, '\n')
+            // Links
+            .replace(/<a[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, '[$2]($1)')
+            // Bold and italic
+            .replace(/<strong[^>]*>([\s\S]*?)<\/strong>/gi, '**$1**')
+            .replace(/<b[^>]*>([\s\S]*?)<\/b>/gi, '**$1**')
+            .replace(/<em[^>]*>([\s\S]*?)<\/em>/gi, '*$1*')
+            .replace(/<i[^>]*>([\s\S]*?)<\/i>/gi, '*$1*')
+            // Code
+            .replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, '`$1`')
+            .replace(/<pre[^>]*>([\s\S]*?)<\/pre>/gi, '\n```\n$1\n```\n')
+            // Blockquotes
+            .replace(/<blockquote[^>]*>([\s\S]*?)<\/blockquote>/gi, '\n> $1\n')
+            // Line breaks
+            .replace(/<br\s*\/?>/gi, '\n')
+            // Dividers
+            .replace(/<hr[^>]*\/?>/gi, '\n---\n')
+            // Remove remaining HTML tags
+            .replace(/<[^>]+>/g, '')
+            // Decode HTML entities
+            .replace(/&nbsp;/g, ' ')
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'")
+            // Clean up whitespace
+            .replace(/\n{3,}/g, '\n\n')
+            .trim();
+        return content;
+    }
+    /**
+     * Extract title from Notion HTML
+     */
+    extractTitle(html) {
+        // Try og:title
+        const ogMatch = html.match(/<meta[^>]*property="og:title"[^>]*content="([^"]+)"/i);
+        if (ogMatch) {
+            return ogMatch[1];
+        }
+        // Try title tag
+        const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+        if (titleMatch) {
+            return titleMatch[1].replace(' | Notion', '').trim();
+        }
+        return 'Notion Page';
+    }
+    /**
+     * Fetch via Notion API (for private pages or search)
+     */
+    async fetchViaApi(identifier, options) {
+        const token = await this.getApiKey('token');
+        // Check if it's a URL and extract ID
+        if (this.isNotionUrl(identifier)) {
+            const id = this.extractIdFromUrl(identifier);
+            return this.fetchPageById(token, id);
+        }
+        // Check if it's a Notion ID
+        if (this.isNotionId(identifier)) {
+            return this.fetchPageById(token, identifier);
+        }
+        // Treat as search query
+        return this.searchNotion(token, identifier, options);
+    }
+    isNotionId(str) {
+        const cleaned = str.replace(/-/g, '');
+        return /^[a-f0-9]{32}$/i.test(cleaned);
+    }
+    extractIdFromUrl(url) {
+        const match = url.match(/([a-f0-9]{32})/i);
+        if (match) {
+            return match[1];
+        }
+        const segments = url.split(/[-/]/);
+        for (let i = segments.length - 1; i >= 0; i--) {
+            const segment = segments[i].replace(/\?.*$/, '');
+            if (/^[a-f0-9]{32}$/i.test(segment)) {
+                return segment;
+            }
+        }
+        this.error(`Could not extract Notion ID from URL: ${url}`);
+    }
+    formatNotionId(id) {
+        const clean = id.replace(/-/g, '');
+        return `${clean.slice(0, 8)}-${clean.slice(8, 12)}-${clean.slice(12, 16)}-${clean.slice(16, 20)}-${clean.slice(20)}`;
+    }
+    async fetchPageById(token, id) {
+        const formattedId = this.formatNotionId(id);
+        try {
+            const page = (await this.apiRequest(token, 'GET', `/pages/${formattedId}`));
+            const blocks = await this.apiRequest(token, 'GET', `/blocks/${formattedId}/children?page_size=100`);
+            return this.formatPage(page, blocks.results);
+        }
+        catch {
+            // Try as database
+            try {
+                const database = (await this.apiRequest(token, 'GET', `/databases/${formattedId}`));
+                const items = await this.apiRequest(token, 'POST', `/databases/${formattedId}/query`, {
+                    page_size: 50,
+                });
+                return this.formatDatabase(database, items.results);
+            }
+            catch {
+                this.error(`Could not fetch Notion page or database: ${id}`);
+            }
+        }
+    }
+    async searchNotion(token, query, options) {
+        const response = (await this.apiRequest(token, 'POST', '/search', {
+            query,
+            filter: { property: 'object', value: 'page' },
+            page_size: options?.limit || 10,
+        }));
+        const results = response.results;
+        if (results.length === 0) {
+            return {
+                content: `# Search: "${query}"\n\nNo results found.`,
+                source: `notion:search:${query}`,
+                title: `Search: ${query}`,
+                metadata: { type: 'notion', query, results: 0 },
+            };
+        }
+        const sections = [`# Search: "${query}"\n`];
+        for (const page of results) {
+            const title = this.getPageTitle(page);
+            sections.push(`## ${title}\n`);
+            try {
+                const blocks = await this.apiRequest(token, 'GET', `/blocks/${page.id}/children?page_size=100`);
+                sections.push(this.blocksToMarkdown(blocks.results));
+            }
+            catch {
+                sections.push('*Could not fetch page content*');
+            }
+            sections.push('\n---\n');
+        }
+        return {
+            content: sections.join('\n'),
+            source: `notion:search:${query}`,
+            title: `Search: ${query}`,
+            metadata: {
+                type: 'notion',
+                query,
+                results: results.length,
+            },
+        };
+    }
+    async apiRequest(token, method, path, body) {
+        const response = await fetch(`${this.API_BASE}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Notion-Version': this.API_VERSION,
+                'Content-Type': 'application/json',
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                this.error('Invalid Notion token. Run: ralph-starter config set notion.token <token>');
+            }
+            if (response.status === 404) {
+                throw new Error('Not found');
+            }
+            const error = (await response.json().catch(() => ({})));
+            this.error(`Notion API error: ${response.status} - ${error.message || response.statusText}`);
+        }
+        return response.json();
+    }
+    formatPage(page, blocks) {
+        const title = this.getPageTitle(page);
+        const content = this.blocksToMarkdown(blocks);
+        return {
+            content: `# ${title}\n\n${content}`,
+            source: `notion:${page.id}`,
+            title,
+            metadata: {
+                type: 'notion',
+                method: 'api',
+                objectType: 'page',
+                id: page.id,
+            },
+        };
+    }
+    formatDatabase(database, items) {
+        const title = this.getDatabaseTitle(database);
+        const sections = [`# ${title}\n`];
+        if (items.length === 0) {
+            sections.push('*No items in database*');
+        }
+        else {
+            for (const item of items) {
+                const itemTitle = this.getPageTitle(item);
+                sections.push(`## ${itemTitle}\n`);
+                const props = this.formatProperties(item.properties);
+                if (props) {
+                    sections.push(props);
+                }
+                sections.push('');
+            }
+        }
+        return {
+            content: sections.join('\n'),
+            source: `notion:${database.id}`,
+            title,
+            metadata: {
+                type: 'notion',
+                method: 'api',
+                objectType: 'database',
+                id: database.id,
+                items: items.length,
+            },
+        };
+    }
+    getPageTitle(page) {
+        const titleProp = Object.values(page.properties || {}).find((p) => p.type === 'title');
+        if (titleProp?.title?.[0]?.plain_text) {
+            return titleProp.title[0].plain_text;
+        }
+        return 'Untitled';
+    }
+    getDatabaseTitle(database) {
+        if (database.title?.[0]?.plain_text) {
+            return database.title[0].plain_text;
+        }
+        return 'Untitled Database';
+    }
+    formatProperties(properties) {
+        const lines = [];
+        for (const [key, prop] of Object.entries(properties)) {
+            const typedProp = prop;
+            if (typedProp.type === 'title')
+                continue;
+            const value = this.getPropertyValue(prop);
+            if (value) {
+                lines.push(`- **${key}**: ${value}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    getPropertyValue(prop) {
+        const p = prop;
+        switch (p.type) {
+            case 'rich_text':
+                return p.rich_text?.[0]?.plain_text || null;
+            case 'number':
+                return p.number?.toString() || null;
+            case 'select':
+                return p.select?.name || null;
+            case 'multi_select':
+                return p.multi_select?.map((s) => s.name).join(', ') || null;
+            case 'date':
+                return p.date?.start || null;
+            case 'checkbox':
+                return p.checkbox ? '✓' : '✗';
+            case 'url':
+                return p.url || null;
+            case 'status':
+                return p.status?.name || null;
+            default:
+                return null;
+        }
+    }
+    blocksToMarkdown(blocks) {
+        const lines = [];
+        for (const block of blocks) {
+            const md = this.blockToMarkdown(block);
+            if (md) {
+                lines.push(md);
+            }
+        }
+        return lines.join('\n');
+    }
+    blockToMarkdown(block) {
+        const content = block[block.type];
+        if (!content)
+            return '';
+        const text = this.richTextToPlain(content.rich_text);
+        switch (block.type) {
+            case 'paragraph':
+                return `${text}\n`;
+            case 'heading_1':
+                return `## ${text}\n`;
+            case 'heading_2':
+                return `### ${text}\n`;
+            case 'heading_3':
+                return `#### ${text}\n`;
+            case 'bulleted_list_item':
+                return `- ${text}`;
+            case 'numbered_list_item':
+                return `1. ${text}`;
+            case 'to_do': {
+                const checked = content.checked ? 'x' : ' ';
+                return `- [${checked}] ${text}`;
+            }
+            case 'toggle':
+                return `<details>\n<summary>${text}</summary>\n</details>\n`;
+            case 'quote':
+                return `> ${text}\n`;
+            case 'callout': {
+                const emoji = content.icon?.emoji || '💡';
+                return `> ${emoji} ${text}\n`;
+            }
+            case 'code': {
+                const lang = content.language || '';
+                return `\`\`\`${lang}\n${text}\n\`\`\`\n`;
+            }
+            case 'divider':
+                return '---\n';
+            case 'image': {
+                const url = content.file?.url || content.external?.url || '';
+                return url ? `![Image](${url})\n` : '';
+            }
+            default:
+                return text ? `${text}\n` : '';
+        }
+    }
+    richTextToPlain(richText) {
+        if (!richText)
+            return '';
+        return richText.map((t) => t.plain_text || '').join('');
+    }
+    getHelp() {
+        return `
+notion: Fetch pages from Notion
+
+Usage:
+  ralph-starter run --from notion --project "https://notion.so/Page-Name-abc123"
+  ralph-starter run --from notion --project "search query"
+
+Options:
+  --project  Page URL, page ID, or search query
+  --limit    Maximum results for search (default: 10)
+
+Authentication:
+
+For public pages (no auth needed):
+  Just provide the Notion URL - ralph-starter will fetch the HTML directly.
+
+For private pages:
+  1. Create integration at: https://www.notion.so/my-integrations
+  2. Run: ralph-starter config set notion.token <token>
+  3. Share pages/databases with your integration in Notion
+
+Examples:
+  # Public page (no auth)
+  ralph-starter run --from notion --project "https://notion.so/Public-Docs-abc123"
+
+  # Private page (with token)
+  ralph-starter run --from notion --project "https://notion.so/Private-Spec-abc123"
+
+  # Search (requires token)
+  ralph-starter run --from notion --project "Product Requirements"
+
+Notes:
+  - Public pages are fetched via HTML (faster, no token needed)
+  - Private pages require API token and sharing with integration
+  - Search only finds pages, not databases
+`.trim();
+    }
+}
+//# sourceMappingURL=source.js.map

package/dist/integrations/notion/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/integrations/notion/source.ts"],"names":[],"mappings":"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"}

package/dist/llm/api.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Unified LLM API for ralph-starter
+ * Supports Anthropic, OpenAI, and OpenRouter
+ */
+import { type LLMProvider } from './providers.js';
+export interface LLMRequest {
+    prompt: string;
+    maxTokens?: number;
+    model?: string;
+}
+export interface LLMResponse {
+    content: string;
+    model: string;
+    provider: LLMProvider;
+}
+/**
+ * Unified LLM call function
+ * Calls the appropriate provider API based on provider type
+ */
+export declare function callLLM(provider: LLMProvider, apiKey: string, request: LLMRequest): Promise<LLMResponse>;
+/**
+ * Try to call LLM with auto-detected or specified provider
+ * Returns null if no API key is available
+ */
+export declare function tryCallLLM(request: LLMRequest, options?: {
+    provider?: LLMProvider;
+    apiKey?: string;
+}): Promise<LLMResponse | null>;
+//# sourceMappingURL=api.d.ts.map

package/dist/llm/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/llm/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAyB,KAAK,WAAW,EAAa,MAAM,gBAAgB,CAAC;AAKpF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;CACvB;AAkID;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqB7B"}

package/dist/llm/api.js

@@ -0,0 +1,152 @@
+/**
+ * Unified LLM API for ralph-starter
+ * Supports Anthropic, OpenAI, and OpenRouter
+ */
+import { getProviderKeyFromEnv, PROVIDERS } from './providers.js';
+// Timeout for API calls (30 seconds)
+const API_TIMEOUT_MS = 30000;
+/**
+ * Fetch with timeout using AbortController
+ */
+async function fetchWithTimeout(url, options, timeoutMs = API_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            ...options,
+            signal: controller.signal,
+        });
+        return response;
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error(`Request timed out after ${timeoutMs / 1000}s`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Call Anthropic API
+ */
+async function callAnthropic(apiKey, request) {
+    const config = PROVIDERS.anthropic;
+    const model = request.model || config.defaultModel;
+    const response = await fetchWithTimeout(config.apiUrl, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'x-api-key': apiKey,
+            'anthropic-version': '2023-06-01',
+        },
+        body: JSON.stringify({
+            model,
+            max_tokens: request.maxTokens || 1024,
+            messages: [
+                {
+                    role: 'user',
+                    content: request.prompt,
+                },
+            ],
+        }),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Anthropic API error ${response.status}: ${errorText}`);
+    }
+    const data = await response.json();
+    const content = data.content?.[0]?.text;
+    if (!content) {
+        throw new Error('No response content from Anthropic');
+    }
+    return {
+        content,
+        model,
+        provider: 'anthropic',
+    };
+}
+/**
+ * Call OpenAI-compatible API (OpenAI and OpenRouter)
+ */
+async function callOpenAICompatible(provider, apiKey, request) {
+    const config = PROVIDERS[provider];
+    const model = request.model || config.defaultModel;
+    const headers = {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${apiKey}`,
+    };
+    // OpenRouter requires additional headers
+    if (provider === 'openrouter') {
+        headers['HTTP-Referer'] = 'https://github.com/ralph-starter';
+        headers['X-Title'] = 'ralph-starter';
+    }
+    const response = await fetchWithTimeout(config.apiUrl, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({
+            model,
+            max_tokens: request.maxTokens || 1024,
+            messages: [
+                {
+                    role: 'user',
+                    content: request.prompt,
+                },
+            ],
+        }),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`${config.displayName} API error ${response.status}: ${errorText}`);
+    }
+    const data = await response.json();
+    const content = data.choices?.[0]?.message?.content;
+    if (!content) {
+        throw new Error(`No response content from ${config.displayName}`);
+    }
+    return {
+        content,
+        model,
+        provider,
+    };
+}
+/**
+ * Unified LLM call function
+ * Calls the appropriate provider API based on provider type
+ */
+export async function callLLM(provider, apiKey, request) {
+    switch (provider) {
+        case 'anthropic':
+            return callAnthropic(apiKey, request);
+        case 'openai':
+        case 'openrouter':
+            return callOpenAICompatible(provider, apiKey, request);
+        default:
+            throw new Error(`Unknown provider: ${provider}`);
+    }
+}
+/**
+ * Try to call LLM with auto-detected or specified provider
+ * Returns null if no API key is available
+ */
+export async function tryCallLLM(request, options) {
+    const { provider, apiKey } = options || {};
+    // If provider and key specified, use them
+    if (provider && apiKey) {
+        return callLLM(provider, apiKey, request);
+    }
+    // Try to find an available provider
+    const providers = provider ? [provider] : ['anthropic', 'openai', 'openrouter'];
+    for (const p of providers) {
+        const key = apiKey || getProviderKeyFromEnv(p);
+        if (key) {
+            try {
+                return await callLLM(p, key, request);
+            }
+            catch { }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=api.js.map

package/dist/llm/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/llm/api.ts"],"names":[],"mappings":"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"}