@oh-my-pi/pi-web-ui 1.337.0

package/src/dialogs/SettingsDialog.ts

@@ -0,0 +1,216 @@
+import { i18n } from "@mariozechner/mini-lit";
+import { Dialog, DialogContent, DialogHeader } from "@mariozechner/mini-lit/dist/Dialog.js";
+import { Input } from "@mariozechner/mini-lit/dist/Input.js";
+import { Label } from "@mariozechner/mini-lit/dist/Label.js";
+import { Switch } from "@mariozechner/mini-lit/dist/Switch.js";
+import { getProviders } from "@oh-my-pi/pi-ai";
+import { html, LitElement, type TemplateResult } from "lit";
+import { customElement, property, state } from "lit/decorators.js";
+import "../components/ProviderKeyInput.js";
+import { getAppStorage } from "../storage/app-storage.js";
+
+// Base class for settings tabs
+export abstract class SettingsTab extends LitElement {
+	abstract getTabName(): string;
+
+	protected createRenderRoot() {
+		return this;
+	}
+}
+
+// API Keys Tab
+@customElement("api-keys-tab")
+export class ApiKeysTab extends SettingsTab {
+	getTabName(): string {
+		return i18n("API Keys");
+	}
+
+	render(): TemplateResult {
+		const providers = getProviders();
+
+		return html`
+			<div class="flex flex-col gap-6">
+				<p class="text-sm text-muted-foreground">
+					${i18n("Configure API keys for LLM providers. Keys are stored locally in your browser.")}
+				</p>
+				${providers.map((provider) => html`<provider-key-input .provider=${provider}></provider-key-input>`)}
+			</div>
+		`;
+	}
+}
+
+// Proxy Tab
+@customElement("proxy-tab")
+export class ProxyTab extends SettingsTab {
+	@state() private proxyEnabled = false;
+	@state() private proxyUrl = "http://localhost:3001";
+
+	override async connectedCallback() {
+		super.connectedCallback();
+		// Load proxy settings when tab is connected
+		try {
+			const storage = getAppStorage();
+			const enabled = await storage.settings.get<boolean>("proxy.enabled");
+			const url = await storage.settings.get<string>("proxy.url");
+
+			if (enabled !== null) this.proxyEnabled = enabled;
+			if (url !== null) this.proxyUrl = url;
+		} catch (error) {
+			console.error("Failed to load proxy settings:", error);
+		}
+	}
+
+	private async saveProxySettings() {
+		try {
+			const storage = getAppStorage();
+			await storage.settings.set("proxy.enabled", this.proxyEnabled);
+			await storage.settings.set("proxy.url", this.proxyUrl);
+		} catch (error) {
+			console.error("Failed to save proxy settings:", error);
+		}
+	}
+
+	getTabName(): string {
+		return i18n("Proxy");
+	}
+
+	render(): TemplateResult {
+		return html`
+			<div class="flex flex-col gap-4">
+				<p class="text-sm text-muted-foreground">
+					${i18n(
+						"Allows browser-based apps to bypass CORS restrictions when calling LLM providers. Required for Z-AI and Anthropic with OAuth token.",
+					)}
+				</p>
+
+				<div class="flex items-center justify-between">
+					<span class="text-sm font-medium text-foreground">${i18n("Use CORS Proxy")}</span>
+					${Switch({
+						checked: this.proxyEnabled,
+						onChange: (checked: boolean) => {
+							this.proxyEnabled = checked;
+							this.saveProxySettings();
+						},
+					})}
+				</div>
+
+				<div class="space-y-2">
+					${Label({ children: i18n("Proxy URL") })}
+					${Input({
+						type: "text",
+						value: this.proxyUrl,
+						disabled: !this.proxyEnabled,
+						onInput: (e) => {
+							this.proxyUrl = (e.target as HTMLInputElement).value;
+						},
+						onChange: () => this.saveProxySettings(),
+					})}
+					<p class="text-xs text-muted-foreground">
+						${i18n("Format: The proxy must accept requests as <proxy-url>/?url=<target-url>")}
+					</p>
+				</div>
+			</div>
+		`;
+	}
+}
+
+@customElement("settings-dialog")
+export class SettingsDialog extends LitElement {
+	@property({ type: Array, attribute: false }) tabs: SettingsTab[] = [];
+	@state() private isOpen = false;
+	@state() private activeTabIndex = 0;
+
+	protected createRenderRoot() {
+		return this;
+	}
+
+	static async open(tabs: SettingsTab[]) {
+		const dialog = new SettingsDialog();
+		dialog.tabs = tabs;
+		dialog.isOpen = true;
+		document.body.appendChild(dialog);
+	}
+
+	private setActiveTab(index: number) {
+		this.activeTabIndex = index;
+	}
+
+	private renderSidebarItem(tab: SettingsTab, index: number): TemplateResult {
+		const isActive = this.activeTabIndex === index;
+		return html`
+			<button
+				class="w-full text-left px-4 py-3 rounded-md transition-colors ${
+					isActive
+						? "bg-secondary text-foreground font-medium"
+						: "text-muted-foreground hover:bg-secondary/50 hover:text-foreground"
+				}"
+				@click=${() => this.setActiveTab(index)}
+			>
+				${tab.getTabName()}
+			</button>
+		`;
+	}
+
+	private renderMobileTab(tab: SettingsTab, index: number): TemplateResult {
+		const isActive = this.activeTabIndex === index;
+		return html`
+			<button
+				class="px-3 py-2 text-sm font-medium transition-colors ${
+					isActive ? "border-b-2 border-primary text-foreground" : "text-muted-foreground hover:text-foreground"
+				}"
+				@click=${() => this.setActiveTab(index)}
+			>
+				${tab.getTabName()}
+			</button>
+		`;
+	}
+
+	render() {
+		if (this.tabs.length === 0) {
+			return html``;
+		}
+
+		return Dialog({
+			isOpen: this.isOpen,
+			onClose: () => {
+				this.isOpen = false;
+				this.remove();
+			},
+			width: "min(1000px, 90vw)",
+			height: "min(800px, 90vh)",
+			backdropClassName: "bg-black/50 backdrop-blur-sm",
+			children: html`
+				${DialogContent({
+					className: "h-full p-6",
+					children: html`
+						<div class="flex flex-col h-full overflow-hidden">
+							<!-- Header -->
+							<div class="pb-4 flex-shrink-0">${DialogHeader({ title: i18n("Settings") })}</div>
+
+							<!-- Mobile Tabs -->
+							<div class="md:hidden flex flex-shrink-0 pb-4">
+								${this.tabs.map((tab, index) => this.renderMobileTab(tab, index))}
+							</div>
+
+							<!-- Layout -->
+							<div class="flex flex-1 overflow-hidden">
+								<!-- Sidebar (desktop only) -->
+								<div class="hidden md:block w-64 flex-shrink-0 space-y-1">
+									${this.tabs.map((tab, index) => this.renderSidebarItem(tab, index))}
+								</div>
+
+								<!-- Content -->
+								<div class="flex-1 overflow-y-auto md:pl-6">
+									${this.tabs.map(
+										(tab, index) =>
+											html`<div style="display: ${this.activeTabIndex === index ? "block" : "none"}">${tab}</div>`,
+									)}
+								</div>
+							</div>
+						</div>
+					`,
+				})}
+			`,
+		});
+	}
+}

package/src/index.ts

@@ -0,0 +1,115 @@
+// Main chat interface
+
+export type { Agent, AgentMessage, AgentState, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+export type { Model } from "@oh-my-pi/pi-ai";
+export { ChatPanel } from "./ChatPanel.js";
+// Components
+export { AgentInterface } from "./components/AgentInterface.js";
+export { AttachmentTile } from "./components/AttachmentTile.js";
+export { ConsoleBlock } from "./components/ConsoleBlock.js";
+export { ExpandableSection } from "./components/ExpandableSection.js";
+export { Input } from "./components/Input.js";
+export { MessageEditor } from "./components/MessageEditor.js";
+export { MessageList } from "./components/MessageList.js";
+// Message components
+export type { ArtifactMessage, UserMessageWithAttachments } from "./components/Messages.js";
+export {
+	AssistantMessage,
+	convertAttachments,
+	defaultConvertToLlm,
+	isArtifactMessage,
+	isUserMessageWithAttachments,
+	ToolMessage,
+	UserMessage,
+} from "./components/Messages.js";
+// Message renderer registry
+export {
+	getMessageRenderer,
+	type MessageRenderer,
+	type MessageRole,
+	registerMessageRenderer,
+	renderMessage,
+} from "./components/message-renderer-registry.js";
+export {
+	type SandboxFile,
+	SandboxIframe,
+	type SandboxResult,
+	type SandboxUrlProvider,
+} from "./components/SandboxedIframe.js";
+export { StreamingMessageContainer } from "./components/StreamingMessageContainer.js";
+// Sandbox Runtime Providers
+export { ArtifactsRuntimeProvider } from "./components/sandbox/ArtifactsRuntimeProvider.js";
+export { AttachmentsRuntimeProvider } from "./components/sandbox/AttachmentsRuntimeProvider.js";
+export { type ConsoleLog, ConsoleRuntimeProvider } from "./components/sandbox/ConsoleRuntimeProvider.js";
+export {
+	type DownloadableFile,
+	FileDownloadRuntimeProvider,
+} from "./components/sandbox/FileDownloadRuntimeProvider.js";
+export { RuntimeMessageBridge } from "./components/sandbox/RuntimeMessageBridge.js";
+export { RUNTIME_MESSAGE_ROUTER } from "./components/sandbox/RuntimeMessageRouter.js";
+export type { SandboxRuntimeProvider } from "./components/sandbox/SandboxRuntimeProvider.js";
+export { ThinkingBlock } from "./components/ThinkingBlock.js";
+export { ApiKeyPromptDialog } from "./dialogs/ApiKeyPromptDialog.js";
+export { AttachmentOverlay } from "./dialogs/AttachmentOverlay.js";
+// Dialogs
+export { ModelSelector } from "./dialogs/ModelSelector.js";
+export { PersistentStorageDialog } from "./dialogs/PersistentStorageDialog.js";
+export { ProvidersModelsTab } from "./dialogs/ProvidersModelsTab.js";
+export { SessionListDialog } from "./dialogs/SessionListDialog.js";
+export { ApiKeysTab, ProxyTab, SettingsDialog, SettingsTab } from "./dialogs/SettingsDialog.js";
+// Prompts
+export {
+	ARTIFACTS_RUNTIME_PROVIDER_DESCRIPTION_RO,
+	ARTIFACTS_RUNTIME_PROVIDER_DESCRIPTION_RW,
+	ATTACHMENTS_RUNTIME_DESCRIPTION,
+} from "./prompts/prompts.js";
+// Storage
+export { AppStorage, getAppStorage, setAppStorage } from "./storage/app-storage.js";
+export { IndexedDBStorageBackend } from "./storage/backends/indexeddb-storage-backend.js";
+export { Store } from "./storage/store.js";
+export type {
+	AutoDiscoveryProviderType,
+	CustomProvider,
+	CustomProviderType,
+} from "./storage/stores/custom-providers-store.js";
+export { CustomProvidersStore } from "./storage/stores/custom-providers-store.js";
+export { ProviderKeysStore } from "./storage/stores/provider-keys-store.js";
+export { SessionsStore } from "./storage/stores/sessions-store.js";
+export { SettingsStore } from "./storage/stores/settings-store.js";
+export type {
+	IndexConfig,
+	IndexedDBConfig,
+	SessionData,
+	SessionMetadata,
+	StorageBackend,
+	StorageTransaction,
+	StoreConfig,
+} from "./storage/types.js";
+// Artifacts
+export { ArtifactElement } from "./tools/artifacts/ArtifactElement.js";
+export { ArtifactPill } from "./tools/artifacts/ArtifactPill.js";
+export { type Artifact, ArtifactsPanel, type ArtifactsParams } from "./tools/artifacts/artifacts.js";
+export { ArtifactsToolRenderer } from "./tools/artifacts/artifacts-tool-renderer.js";
+export { HtmlArtifact } from "./tools/artifacts/HtmlArtifact.js";
+export { ImageArtifact } from "./tools/artifacts/ImageArtifact.js";
+export { MarkdownArtifact } from "./tools/artifacts/MarkdownArtifact.js";
+export { SvgArtifact } from "./tools/artifacts/SvgArtifact.js";
+export { TextArtifact } from "./tools/artifacts/TextArtifact.js";
+export { createExtractDocumentTool, extractDocumentTool } from "./tools/extract-document.js";
+// Tools
+export { getToolRenderer, registerToolRenderer, renderTool, setShowJsonMode } from "./tools/index.js";
+export { createJavaScriptReplTool, javascriptReplTool } from "./tools/javascript-repl.js";
+export { renderCollapsibleHeader, renderHeader } from "./tools/renderer-registry.js";
+export { BashRenderer } from "./tools/renderers/BashRenderer.js";
+export { CalculateRenderer } from "./tools/renderers/CalculateRenderer.js";
+// Tool renderers
+export { DefaultRenderer } from "./tools/renderers/DefaultRenderer.js";
+export { GetCurrentTimeRenderer } from "./tools/renderers/GetCurrentTimeRenderer.js";
+export type { ToolRenderer, ToolRenderResult } from "./tools/types.js";
+export type { Attachment } from "./utils/attachment-utils.js";
+// Utils
+export { loadAttachment } from "./utils/attachment-utils.js";
+export { clearAuthToken, getAuthToken } from "./utils/auth-token.js";
+export { formatCost, formatModelCost, formatTokenCount, formatUsage } from "./utils/format.js";
+export { i18n, setLanguage, translations } from "./utils/i18n.js";
+export { applyProxyIfNeeded, createStreamFn, isCorsError, shouldUseProxyForProvider } from "./utils/proxy-utils.js";

package/src/prompts/prompts.ts

@@ -0,0 +1,282 @@
+/**
+ * Centralized tool prompts/descriptions.
+ * Each prompt is either a string constant or a template function.
+ */
+
+// ============================================================================
+// JavaScript REPL Tool
+// ============================================================================
+
+export const JAVASCRIPT_REPL_TOOL_DESCRIPTION = (runtimeProviderDescriptions: string[]) => `# JavaScript REPL
+
+## Purpose
+Execute JavaScript code in a sandboxed browser environment with full Web APIs.
+
+## When to Use
+- Quick calculations or data transformations
+- Testing JavaScript code snippets in isolation
+- Processing data with libraries (XLSX, CSV, etc.)
+- Creating artifacts from data
+
+## Environment
+- ES2023+ JavaScript (async/await, optional chaining, nullish coalescing, etc.)
+- All browser APIs: DOM, Canvas, WebGL, Fetch, Web Workers, WebSockets, Crypto, etc.
+- Import any npm package: await import('https://esm.run/package-name')
+
+## Common Libraries
+- XLSX: const XLSX = await import('https://esm.run/xlsx');
+- CSV: const Papa = (await import('https://esm.run/papaparse')).default;
+- Chart.js: const Chart = (await import('https://esm.run/chart.js/auto')).default;
+- Three.js: const THREE = await import('https://esm.run/three');
+
+## Persistence between tool calls
+- Objects stored on global scope do not persist between calls.
+- Use artifacts as a key-value JSON object store:
+  - Use createOrUpdateArtifact(filename, content) to persist data between calls. JSON objects are auto-stringified.
+  - Use listArtifacts() and getArtifact(filename) to read persisted data. JSON files are auto-parsed to objects.
+  - Prefer to use a single artifact throughout the session to store intermediate data (e.g. 'data.json').
+
+## Input
+- You have access to the user's attachments via listAttachments(), readTextAttachment(id), and readBinaryAttachment(id)
+- You have access to previously created artifacts via listArtifacts() and getArtifact(filename)
+
+## Output
+- All console.log() calls are captured for you to inspect. The user does not see these logs.
+- Create artifacts for file results (images, JSON, CSV, etc.) which persiste throughout the
+  session and are accessible to you and the user.
+
+## Example
+const data = [10, 20, 15, 25];
+const sum = data.reduce((a, b) => a + b, 0);
+const avg = sum / data.length;
+console.log('Sum:', sum, 'Average:', avg);
+
+## Important Notes
+- Graphics: Use fixed dimensions (800x600), NOT window.innerWidth/Height
+- Chart.js: Set options: { responsive: false, animation: false }
+- Three.js: renderer.setSize(800, 600) with matching aspect ratio
+
+## Helper Functions (Automatically Available)
+
+These functions are injected into the execution environment and available globally:
+
+${runtimeProviderDescriptions.join("\n\n")}
+`;
+
+// ============================================================================
+// Artifacts Tool
+// ============================================================================
+
+export const ARTIFACTS_TOOL_DESCRIPTION = (runtimeProviderDescriptions: string[]) => `# Artifacts
+
+Create and manage persistent files that live alongside the conversation.
+
+## When to Use - Artifacts Tool vs REPL
+
+**Use artifacts tool when YOU are the author:**
+- Writing research summaries, analysis, ideas, documentation
+- Creating markdown notes for user to read
+- Building HTML applications/visualizations that present data
+- Creating HTML artifacts that render charts from programmatically generated data
+
+**Use repl + artifact storage functions when CODE processes data:**
+- Scraping workflows that extract and store data
+- Processing CSV/Excel files programmatically
+- Data transformation pipelines
+- Binary file generation requiring libraries (PDF, DOCX)
+
+**Pattern: REPL generates data → Artifacts tool creates HTML that visualizes it**
+Example: repl scrapes products → stores products.json → you author dashboard.html that reads products.json and renders Chart.js visualizations
+
+## Input
+- { action: "create", filename: "notes.md", content: "..." } - Create new file
+- { action: "update", filename: "notes.md", old_str: "...", new_str: "..." } - Update part of file (PREFERRED)
+- { action: "rewrite", filename: "notes.md", content: "..." } - Replace entire file (LAST RESORT)
+- { action: "get", filename: "data.json" } - Retrieve file content
+- { action: "delete", filename: "old.csv" } - Delete file
+- { action: "htmlArtifactLogs", filename: "app.html" } - Get console logs from HTML artifact
+
+## Returns
+Depends on action:
+- create/update/rewrite/delete: Success status or error
+- get: File content
+- htmlArtifactLogs: Console logs and errors
+
+## Supported File Types
+✅ Text-based files you author: .md, .txt, .html, .js, .css, .json, .csv, .svg
+❌ Binary files requiring libraries (use repl): .pdf, .docx
+
+## Critical - Prefer Update Over Rewrite
+❌ NEVER: get entire file + rewrite to change small sections
+✅ ALWAYS: update for targeted edits (token efficient)
+✅ Ask: Can I describe the change as old_str → new_str? Use update.
+
+---
+
+## HTML Artifacts
+
+Interactive HTML applications that can visualize data from other artifacts.
+
+### Data Access
+- Can read artifacts created by repl and user attachments
+- Use to build dashboards, visualizations, interactive tools
+- See Helper Functions section below for available functions
+
+### Requirements
+- Self-contained single file
+- Import ES modules from esm.sh: <script type="module">import X from 'https://esm.sh/pkg';</script>
+- Use Tailwind CDN: <script src="https://cdn.tailwindcss.com"></script>
+- Can embed images from any domain: <img src="https://example.com/image.jpg">
+- MUST set background color explicitly (avoid transparent)
+- Inline CSS or Tailwind utility classes
+- No localStorage/sessionStorage
+
+### Styling
+- Use Tailwind utility classes for clean, functional designs
+- Ensure responsive layout (iframe may be resized)
+- Avoid purple gradients, AI aesthetic clichés, and emojis
+
+### Helper Functions (Automatically Available)
+
+These functions are injected into HTML artifact sandbox:
+
+${runtimeProviderDescriptions.join("\n\n")}
+`;
+
+// ============================================================================
+// Artifacts Runtime Provider
+// ============================================================================
+
+export const ARTIFACTS_RUNTIME_PROVIDER_DESCRIPTION_RW = `
+### Artifacts Storage
+
+Create, read, update, and delete files in artifacts storage.
+
+#### When to Use
+- Store intermediate results between tool calls
+- Save generated files (images, CSVs, processed data) for user to view and download
+
+#### Do NOT Use For
+- Content you author directly, like summaries of content you read (use artifacts tool instead)
+
+#### Functions
+- listArtifacts() - List all artifact filenames, returns Promise<string[]>
+- getArtifact(filename) - Read artifact content, returns Promise<string | object>. JSON files auto-parse to objects, binary files return base64 string
+- createOrUpdateArtifact(filename, content, mimeType?) - Create or update artifact, returns Promise<void>. JSON files auto-stringify objects, binary requires base64 string with mimeType
+- deleteArtifact(filename) - Delete artifact, returns Promise<void>
+
+#### Example
+JSON workflow:
+\`\`\`javascript
+// Fetch and save
+const response = await fetch('https://api.example.com/products');
+const products = await response.json();
+await createOrUpdateArtifact('products.json', products);
+
+// Later: read and filter
+const all = await getArtifact('products.json');
+const cheap = all.filter(p => p.price < 100);
+await createOrUpdateArtifact('cheap.json', cheap);
+\`\`\`
+
+Binary file (image):
+\`\`\`javascript
+const canvas = document.createElement('canvas');
+canvas.width = 800; canvas.height = 600;
+const ctx = canvas.getContext('2d');
+ctx.fillStyle = 'blue';
+ctx.fillRect(0, 0, 800, 600);
+// Remove data:image/png;base64, prefix
+const base64 = canvas.toDataURL().split(',')[1];
+await createOrUpdateArtifact('chart.png', base64, 'image/png');
+\`\`\`
+`;
+
+export const ARTIFACTS_RUNTIME_PROVIDER_DESCRIPTION_RO = `
+### Artifacts Storage
+
+Read files from artifacts storage.
+
+#### When to Use
+- Read artifacts created by REPL or artifacts tool
+- Access data from other HTML artifacts
+- Load configuration or data files
+
+#### Do NOT Use For
+- Creating new artifacts (not available in HTML artifacts)
+- Modifying artifacts (read-only access)
+
+#### Functions
+- listArtifacts() - List all artifact filenames, returns Promise<string[]>
+- getArtifact(filename) - Read artifact content, returns Promise<string | object>. JSON files auto-parse to objects, binary files return base64 string
+
+#### Example
+JSON data:
+\`\`\`javascript
+const products = await getArtifact('products.json');
+const html = products.map(p => \`<div>\${p.name}: $\${p.price}</div>\`).join('');
+document.body.innerHTML = html;
+\`\`\`
+
+Binary image:
+\`\`\`javascript
+const base64 = await getArtifact('chart.png');
+const img = document.createElement('img');
+img.src = 'data:image/png;base64,' + base64;
+document.body.appendChild(img);
+\`\`\`
+`;
+
+// ============================================================================
+// Attachments Runtime Provider
+// ============================================================================
+
+export const ATTACHMENTS_RUNTIME_DESCRIPTION = `
+### User Attachments
+
+Read files the user uploaded to the conversation.
+
+#### When to Use
+- Process user-uploaded files (CSV, JSON, Excel, images, PDFs)
+
+#### Functions
+- listAttachments() - List all attachments, returns array of {id, fileName, mimeType, size}
+- readTextAttachment(id) - Read attachment as text, returns string
+- readBinaryAttachment(id) - Read attachment as binary data, returns Uint8Array
+
+#### Example
+CSV file:
+\`\`\`javascript
+const files = listAttachments();
+const csvFile = files.find(f => f.fileName.endsWith('.csv'));
+const csvData = readTextAttachment(csvFile.id);
+const rows = csvData.split('\\n').map(row => row.split(','));
+\`\`\`
+
+Excel file:
+\`\`\`javascript
+const XLSX = await import('https://esm.run/xlsx');
+const files = listAttachments();
+const xlsxFile = files.find(f => f.fileName.endsWith('.xlsx'));
+const bytes = readBinaryAttachment(xlsxFile.id);
+const workbook = XLSX.read(bytes);
+const data = XLSX.utils.sheet_to_json(workbook.Sheets[workbook.SheetNames[0]]);
+\`\`\`
+`;
+
+// ============================================================================
+// Extract Document Tool
+// ============================================================================
+
+export const EXTRACT_DOCUMENT_DESCRIPTION = `# Extract Document
+
+Extract plain text from documents on the web (PDF, DOCX, XLSX, PPTX).
+
+## When to Use
+User wants you to read a document at a URL.
+
+## Input
+- { url: "https://example.com/document.pdf" } - URL to PDF, DOCX, XLSX, or PPTX
+
+## Returns
+Structured plain text with page/sheet/slide delimiters.`;

package/src/storage/app-storage.ts

@@ -0,0 +1,60 @@
+import type { CustomProvidersStore } from "./stores/custom-providers-store.js";
+import type { ProviderKeysStore } from "./stores/provider-keys-store.js";
+import type { SessionsStore } from "./stores/sessions-store.js";
+import type { SettingsStore } from "./stores/settings-store.js";
+import type { StorageBackend } from "./types.js";
+
+/**
+ * High-level storage API providing access to all storage operations.
+ * Subclasses can extend this to add domain-specific stores.
+ */
+export class AppStorage {
+	readonly backend: StorageBackend;
+	readonly settings: SettingsStore;
+	readonly providerKeys: ProviderKeysStore;
+	readonly sessions: SessionsStore;
+	readonly customProviders: CustomProvidersStore;
+
+	constructor(
+		settings: SettingsStore,
+		providerKeys: ProviderKeysStore,
+		sessions: SessionsStore,
+		customProviders: CustomProvidersStore,
+		backend: StorageBackend,
+	) {
+		this.settings = settings;
+		this.providerKeys = providerKeys;
+		this.sessions = sessions;
+		this.customProviders = customProviders;
+		this.backend = backend;
+	}
+
+	async getQuotaInfo(): Promise<{ usage: number; quota: number; percent: number }> {
+		return this.backend.getQuotaInfo();
+	}
+
+	async requestPersistence(): Promise<boolean> {
+		return this.backend.requestPersistence();
+	}
+}
+
+// Global instance management
+let globalAppStorage: AppStorage | null = null;
+
+/**
+ * Get the global AppStorage instance.
+ * Throws if not initialized.
+ */
+export function getAppStorage(): AppStorage {
+	if (!globalAppStorage) {
+		throw new Error("AppStorage not initialized. Call setAppStorage() first.");
+	}
+	return globalAppStorage;
+}
+
+/**
+ * Set the global AppStorage instance.
+ */
+export function setAppStorage(storage: AppStorage): void {
+	globalAppStorage = storage;
+}