@autumnsgrove/groveengine 0.8.0 → 0.8.5

package/dist/components/WispPanel.svelte.d.ts

@@ -0,0 +1,49 @@
+export default WispPanel;
+type WispPanel = {
+    $on?(type: string, callback: (e: any) => void): () => void;
+    $set?(props: Partial<Props>): void;
+};
+declare const WispPanel: import("svelte").Component<{
+    /**
+     * - Content to analyze
+     */
+    content: string;
+    /**
+     * - Whether Wisp is enabled
+     */
+    enabled: boolean;
+    /**
+     * - Optional post title for context
+     */
+    postTitle: string;
+    /**
+     * - Optional post slug for logging
+     */
+    postSlug: string;
+    /**
+     * - Callback when user applies a fix
+     */
+    onApplyFix: (original: string, suggestion: string) => void;
+}, {}, "">;
+type Props = {
+    /**
+     * - Content to analyze
+     */
+    content: string;
+    /**
+     * - Whether Wisp is enabled
+     */
+    enabled: boolean;
+    /**
+     * - Optional post title for context
+     */
+    postTitle: string;
+    /**
+     * - Optional post slug for logging
+     */
+    postSlug: string;
+    /**
+     * - Callback when user applies a fix
+     */
+    onApplyFix: (original: string, suggestion: string) => void;
+};

package/dist/components/custom/TableOfContents.svelte

@@ -41,9 +41,20 @@
 	function scrollToHeader(id) {
 		const element = document.getElementById(id);
 		if (element) {
-			element.scrollIntoView({ behavior: 'smooth', block: 'start' });
+			// Calculate offset for sticky headers
+			const offset = 80; // Account for any fixed headers
+			const elementPosition = element.getBoundingClientRect().top + window.pageYOffset;
+			const offsetPosition = elementPosition - offset;
+
+			window.scrollTo({
+				top: offsetPosition,
+				behavior: 'smooth'
+			});
+			
 			// Update URL hash without jumping
 			history.pushState(null, '', `#${id}`);
+		} else {
+			console.warn(`TableOfContents: Header element not found for ID: ${id}`);
 		}
 	}
 </script>

package/dist/components/quota/UpgradePrompt.svelte

@@ -187,6 +187,7 @@
       aria-modal="true"
       aria-labelledby="upgrade-title"
       aria-describedby="upgrade-description"
+      tabindex="0"
     >
       <!-- Header -->
       <div class="text-center mb-6">

package/dist/config/wisp.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Calculate cost for token usage
+ * @param {string} model - Model key
+ * @param {number} inputTokens - Number of input tokens
+ * @param {number} outputTokens - Number of output tokens
+ * @returns {number} Cost in USD (rounded to 6 decimal places to avoid floating point errors)
+ */
+export function calculateCost(model: string, inputTokens: number, outputTokens: number): number;
+/**
+ * Get the model ID for a provider
+ * @param {string} provider - Provider key
+ * @param {string} model - Model key
+ * @returns {string|null} Full model ID or null if not found
+ */
+export function getModelId(provider: string, model: string): string | null;
+/**
+ * Get provider configuration
+ * @param {string} provider - Provider key
+ * @returns {object|null} Provider config or null
+ */
+export function getProvider(provider: string): object | null;
+/**
+ * Get max tokens for an action and mode
+ * @param {'grammar'|'tone'|'readability'} action
+ * @param {'quick'|'thorough'} mode
+ * @returns {number}
+ */
+export function getMaxTokens(action: "grammar" | "tone" | "readability", mode?: "quick" | "thorough"): number;
+export namespace PROVIDERS {
+    namespace fireworks {
+        let name: string;
+        let baseUrl: string;
+        let role: string;
+        let zdr: boolean;
+        let models: {
+            'deepseek-v3.2': string;
+            'kimi-k2': string;
+            'llama-3.1-70b': string;
+        };
+    }
+    namespace cerebras {
+        let name_1: string;
+        export { name_1 as name };
+        let baseUrl_1: string;
+        export { baseUrl_1 as baseUrl };
+        let role_1: string;
+        export { role_1 as role };
+        let zdr_1: boolean;
+        export { zdr_1 as zdr };
+        let models_1: {
+            'llama-3.3-70b': string;
+            'gpt-oss-120b': string;
+        };
+        export { models_1 as models };
+    }
+    namespace groq {
+        let name_2: string;
+        export { name_2 as name };
+        let baseUrl_2: string;
+        export { baseUrl_2 as baseUrl };
+        let role_2: string;
+        export { role_2 as role };
+        let zdr_2: boolean;
+        export { zdr_2 as zdr };
+        let models_2: {
+            'llama-3.3-70b': string;
+        };
+        export { models_2 as models };
+    }
+}
+/**
+ * Model fallback cascade
+ * Try in order until one succeeds
+ */
+export const MODEL_FALLBACK_CASCADE: {
+    provider: string;
+    model: string;
+}[];
+export const MODEL_PRICING: {
+    'deepseek-v3.2': {
+        input: number;
+        output: number;
+    };
+    'kimi-k2': {
+        input: number;
+        output: number;
+    };
+    'llama-3.1-70b': {
+        input: number;
+        output: number;
+    };
+    'llama-3.3-70b': {
+        input: number;
+        output: number;
+    };
+    'gpt-oss-120b': {
+        input: number;
+        output: number;
+    };
+};
+/** Maximum content length for analysis (characters) */
+export const MAX_CONTENT_LENGTH: 50000;
+export namespace MAX_OUTPUT_TOKENS {
+    namespace grammar {
+        let quick: number;
+        let thorough: number;
+    }
+    namespace tone {
+        let quick_1: number;
+        export { quick_1 as quick };
+        let thorough_1: number;
+        export { thorough_1 as thorough };
+    }
+    let readability: number;
+}
+export namespace RATE_LIMIT {
+    let maxRequestsPerHour: number;
+    let windowSeconds: number;
+}
+export namespace COST_CAP {
+    let enabled: boolean;
+    let maxCostUSD: number;
+    let warningThreshold: number;
+}
+export namespace PROMPT_MODES {
+    export namespace quick_2 {
+        let name_3: string;
+        export { name_3 as name };
+        export let description: string;
+        export let temperature: number;
+        export let maxOutputMultiplier: number;
+    }
+    export { quick_2 as quick };
+    export namespace thorough_2 {
+        let name_4: string;
+        export { name_4 as name };
+        let description_1: string;
+        export { description_1 as description };
+        let temperature_1: number;
+        export { temperature_1 as temperature };
+        let maxOutputMultiplier_1: number;
+        export { maxOutputMultiplier_1 as maxOutputMultiplier };
+    }
+    export { thorough_2 as thorough };
+}

package/dist/config/wisp.js

@@ -0,0 +1,175 @@
+/**
+ * Wisp - Grove Writing Assistant Configuration
+ *
+ * Model configuration, provider settings, and pricing for the Wisp writing assistant.
+ * Uses privacy-first providers with Zero Data Retention (ZDR).
+ *
+ * @see docs/specs/writing-assistant-unified-spec.md
+ */
+
+// ============================================================================
+// Provider Configuration
+// ============================================================================
+
+/**
+ * Approved inference providers with ZDR support
+ * Order determines fallback priority
+ */
+export const PROVIDERS = {
+	fireworks: {
+		name: 'Fireworks AI',
+		baseUrl: 'https://api.fireworks.ai/inference/v1',
+		role: 'primary',
+		zdr: true, // Zero Data Retention default for open models
+		models: {
+			'deepseek-v3.2': 'accounts/fireworks/models/deepseek-v3p2',
+			'kimi-k2': 'accounts/fireworks/models/kimi-k2-instruct-0905',
+			'llama-3.1-70b': 'accounts/fireworks/models/llama-v3p1-70b-instruct'
+		}
+	},
+	cerebras: {
+		name: 'Cerebras',
+		baseUrl: 'https://api.cerebras.ai/v1',
+		role: 'backup',
+		zdr: true, // US-based, zero retention
+		models: {
+			'llama-3.3-70b': 'llama-3.3-70b',
+			'gpt-oss-120b': 'gpt-oss-120b'
+		}
+	},
+	groq: {
+		name: 'Groq',
+		baseUrl: 'https://api.groq.com/openai/v1',
+		role: 'tertiary',
+		zdr: true, // Explicit ZDR toggle
+		models: {
+			'llama-3.3-70b': 'llama-3.3-70b-versatile'
+		}
+	}
+};
+
+/**
+ * Model fallback cascade
+ * Try in order until one succeeds
+ */
+export const MODEL_FALLBACK_CASCADE = [
+	{ provider: 'fireworks', model: 'deepseek-v3.2' },
+	{ provider: 'fireworks', model: 'kimi-k2' },
+	{ provider: 'fireworks', model: 'llama-3.1-70b' },
+	{ provider: 'cerebras', model: 'llama-3.3-70b' },
+	{ provider: 'groq', model: 'llama-3.3-70b' }
+];
+
+// ============================================================================
+// Pricing (per million tokens)
+// ============================================================================
+
+export const MODEL_PRICING = {
+	'deepseek-v3.2': { input: 0.56, output: 1.68 },
+	'kimi-k2': { input: 0.60, output: 2.50 },
+	'llama-3.1-70b': { input: 0.90, output: 0.90 },
+	'llama-3.3-70b': { input: 0.59, output: 0.79 },
+	'gpt-oss-120b': { input: 0.25, output: 0.69 }
+};
+
+// ============================================================================
+// Limits & Thresholds
+// ============================================================================
+
+/** Maximum content length for analysis (characters) */
+export const MAX_CONTENT_LENGTH = 50000;
+
+/** Max output tokens by analysis type and mode */
+export const MAX_OUTPUT_TOKENS = {
+	grammar: { quick: 1024, thorough: 2048 },
+	tone: { quick: 512, thorough: 1024 },
+	readability: 0 // No AI call needed
+};
+
+/**
+ * Rate limiting (burst protection)
+ * Note: Cost cap is the true monthly limit (~1000 requests at current pricing).
+ * Hourly limit prevents abuse bursts, not total monthly usage.
+ */
+export const RATE_LIMIT = {
+	maxRequestsPerHour: 10,
+	windowSeconds: 3600
+};
+
+/** Monthly cost cap per user (the true usage limit) */
+export const COST_CAP = {
+	enabled: true,
+	maxCostUSD: 5.0,
+	warningThreshold: 0.8 // Warn at 80%
+};
+
+// ============================================================================
+// Prompt Modes
+// ============================================================================
+
+/**
+ * Prompt modes control analysis depth without changing models
+ */
+export const PROMPT_MODES = {
+	quick: {
+		name: 'Quick',
+		description: 'Fast essential checks',
+		temperature: 0.1,
+		maxOutputMultiplier: 1
+	},
+	thorough: {
+		name: 'Thorough',
+		description: 'Comprehensive analysis',
+		temperature: 0.2,
+		maxOutputMultiplier: 2
+	}
+};
+
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+/**
+ * Calculate cost for token usage
+ * @param {string} model - Model key
+ * @param {number} inputTokens - Number of input tokens
+ * @param {number} outputTokens - Number of output tokens
+ * @returns {number} Cost in USD (rounded to 6 decimal places to avoid floating point errors)
+ */
+export function calculateCost(model, inputTokens, outputTokens) {
+	const pricing = MODEL_PRICING[model] || MODEL_PRICING['deepseek-v3.2'];
+	const cost = (inputTokens * pricing.input + outputTokens * pricing.output) / 1_000_000;
+	// Round to 6 decimal places to avoid floating point precision issues
+	return Math.round(cost * 1_000_000) / 1_000_000;
+}
+
+/**
+ * Get the model ID for a provider
+ * @param {string} provider - Provider key
+ * @param {string} model - Model key
+ * @returns {string|null} Full model ID or null if not found
+ */
+export function getModelId(provider, model) {
+	return PROVIDERS[provider]?.models[model] || null;
+}
+
+/**
+ * Get provider configuration
+ * @param {string} provider - Provider key
+ * @returns {object|null} Provider config or null
+ */
+export function getProvider(provider) {
+	return PROVIDERS[provider] || null;
+}
+
+/**
+ * Get max tokens for an action and mode
+ * @param {'grammar'|'tone'|'readability'} action
+ * @param {'quick'|'thorough'} mode
+ * @returns {number}
+ */
+export function getMaxTokens(action, mode = 'quick') {
+	const tokens = MAX_OUTPUT_TOKENS[action];
+	if (typeof tokens === 'number') return tokens;
+	return tokens?.[mode] || 1024;
+}

package/dist/index.d.ts

@@ -6,6 +6,8 @@ export { default as MobileTOC } from './components/custom/MobileTOC.svelte';
 export { default as CollapsibleSection } from './components/custom/CollapsibleSection.svelte';
 export { default as MarkdownEditor } from './components/admin/MarkdownEditor.svelte';
 export { default as GutterManager } from './components/admin/GutterManager.svelte';
+export { default as WispPanel } from './components/WispPanel.svelte';
+export { default as WispButton } from './components/WispButton.svelte';
 export { QuotaWidget, QuotaWarning, UpgradePrompt } from './components/quota/index';
 export { default as ImageGallery } from './ui/components/gallery/ImageGallery.svelte';
 export { default as Lightbox } from './ui/components/gallery/Lightbox.svelte';

package/dist/index.js

@@ -9,6 +9,9 @@ export { default as CollapsibleSection } from './components/custom/CollapsibleSe
 // Admin components
 export { default as MarkdownEditor } from './components/admin/MarkdownEditor.svelte';
 export { default as GutterManager } from './components/admin/GutterManager.svelte';
+// Wisp - Writing Assistant
+export { default as WispPanel } from './components/WispPanel.svelte';
+export { default as WispButton } from './components/WispButton.svelte';
 // Quota components
 export { QuotaWidget, QuotaWarning, UpgradePrompt } from './components/quota/index';
 // Gallery components (from UI module)

package/dist/server/inference-client.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Call an inference API with automatic fallback
+ *
+ * @param {InferenceRequest} request - The inference request
+ * @param {Object} secrets - API keys object
+ * @param {string} [secrets.FIREWORKS_API_KEY] - Fireworks AI key
+ * @param {string} [secrets.CEREBRAS_API_KEY] - Cerebras key
+ * @param {string} [secrets.GROQ_API_KEY] - Groq key
+ * @returns {Promise<InferenceResponse>}
+ * @throws {InferenceClientError}
+ */
+export function callInference(request: InferenceRequest, secrets: {
+    FIREWORKS_API_KEY?: string | undefined;
+    CEREBRAS_API_KEY?: string | undefined;
+    GROQ_API_KEY?: string | undefined;
+}): Promise<InferenceResponse>;
+/**
+ * Wrap user content with security markers to prevent prompt injection
+ *
+ * @param {string} content - User content to analyze
+ * @param {string} taskDescription - Description of the analysis task
+ * @returns {string} Secured prompt with content
+ */
+export function secureUserContent(content: string, taskDescription: string): string;
+/**
+ * Smart truncation for long content
+ * Captures beginning, end, and samples from middle
+ *
+ * @param {string} content - Content to truncate
+ * @param {number} [maxChars=20000] - Maximum characters
+ * @returns {string} Truncated content
+ */
+export function smartTruncate(content: string, maxChars?: number): string;
+/**
+ * @typedef {Object} InferenceRequest
+ * @property {string} prompt - The prompt to send
+ * @property {'quick'|'thorough'} [mode='quick'] - Analysis mode
+ * @property {number} [maxTokens=1024] - Max output tokens
+ * @property {number} [temperature=0.1] - Temperature for generation
+ * @property {string} [preferredProvider] - Preferred provider (optional)
+ * @property {string} [preferredModel] - Preferred model (optional)
+ */
+/**
+ * @typedef {Object} InferenceResponse
+ * @property {string} content - The generated content
+ * @property {Object} usage - Token usage
+ * @property {number} usage.input - Input tokens
+ * @property {number} usage.output - Output tokens
+ * @property {string} model - Model used
+ * @property {string} provider - Provider used
+ */
+/**
+ * @typedef {Object} InferenceError
+ * @property {string} code - Error code
+ * @property {string} message - Error message
+ * @property {string} [provider] - Provider that failed
+ */
+export class InferenceClientError extends Error {
+    /**
+     * @param {string} message
+     * @param {string} code
+     * @param {string} [provider]
+     * @param {unknown} [cause]
+     */
+    constructor(message: string, code: string, provider?: string, cause?: unknown);
+    code: string;
+    provider: string | undefined;
+    cause: unknown;
+}
+/**
+ * Strip markdown formatting for cleaner analysis
+ * Re-exported from readability.js for consistency
+ *
+ * @param {string} content - Markdown content
+ * @returns {string} Plain text content
+ */
+export const stripMarkdown: typeof stripMarkdownForAnalysis;
+export type InferenceRequest = {
+    /**
+     * - The prompt to send
+     */
+    prompt: string;
+    /**
+     * - Analysis mode
+     */
+    mode?: "quick" | "thorough" | undefined;
+    /**
+     * - Max output tokens
+     */
+    maxTokens?: number | undefined;
+    /**
+     * - Temperature for generation
+     */
+    temperature?: number | undefined;
+    /**
+     * - Preferred provider (optional)
+     */
+    preferredProvider?: string | undefined;
+    /**
+     * - Preferred model (optional)
+     */
+    preferredModel?: string | undefined;
+};
+export type InferenceResponse = {
+    /**
+     * - The generated content
+     */
+    content: string;
+    /**
+     * - Token usage
+     */
+    usage: {
+        input: number;
+        output: number;
+    };
+    /**
+     * - Model used
+     */
+    model: string;
+    /**
+     * - Provider used
+     */
+    provider: string;
+};
+export type InferenceError = {
+    /**
+     * - Error code
+     */
+    code: string;
+    /**
+     * - Error message
+     */
+    message: string;
+    /**
+     * - Provider that failed
+     */
+    provider?: string | undefined;
+};
+import { stripMarkdownForAnalysis } from '../utils/readability.js';