@soulcraft/sdk 1.6.2 → 2.0.0

package/dist/server/handlers/settings.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @module server/handlers/settings
+ * @description Settings namespace handler — BYOK API key management, AI usage
+ * stats, and workspace storage usage.
+ *
+ * Absorbs Workshop `routes/settings.ts`. The handler delegates to injected
+ * service interfaces for API key storage, billing, and storage tracking, so
+ * products can plug in their own implementations.
+ *
+ * Methods:
+ * - `saveApiKey` — Save a BYOK API key (encrypted at rest)
+ * - `getApiKey` — Get redacted API key info
+ * - `deleteApiKey` — Delete a saved API key
+ * - `getUsageStats` — Get AI usage statistics for the billing period
+ * - `getStorageUsage` — Get storage consumption breakdown
+ */
+import type { NamespaceProvider } from '../namespace-router.js';
+/**
+ * API key storage interface.
+ *
+ * Products implement this to manage BYOK API key persistence. Workshop uses
+ * encrypted filesystem storage; Venue might use a secrets manager.
+ */
+export interface ApiKeyService {
+    /** Save an API key (encrypted at rest). */
+    saveKey(userId: string, provider: string, apiKey: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get an API key for the given user and provider.
+     *
+     * @returns The key info, including whether it's a personal key or environment fallback.
+     */
+    getKey(userId: string, workspaceId: string, provider: string): Promise<{
+        success: boolean;
+        apiKey?: string;
+        source?: 'workspace' | 'global' | 'environment' | 'none';
+    }>;
+    /** Delete an API key. */
+    deleteKey(userId: string, provider: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /** Validate an API key format before saving. */
+    isValidKey(apiKey: string): boolean;
+}
+/**
+ * Billing service subset needed by the settings handler.
+ */
+export interface SettingsBillingService {
+    /** Get AI usage status for the billing period. */
+    getUsageStatus(billingId: string, hasPersonalKey: boolean): Promise<Record<string, unknown>>;
+    /** Get the user's subscription for plan-based storage limits. */
+    getSubscription(billingId: string): Promise<{
+        plan?: string;
+    } | null>;
+}
+/**
+ * Storage tracking service for instant storage usage queries.
+ */
+export interface StorageTracker {
+    /** Get cached storage usage in bytes. */
+    getUsage(storageId: string, workspaceId: string): Promise<number>;
+    /** Whether the tracker has initialized for this user+workspace. */
+    isInitialized(storageId: string, workspaceId: string): boolean;
+    /** Force a one-time initialization (first load). */
+    forceInit(storageId: string, workspaceId: string): Promise<number>;
+}
+/**
+ * Storage limit resolver — maps plan ID to maximum bytes allowed.
+ */
+export interface StorageLimitResolver {
+    /** Get the storage limit in bytes for the given plan. */
+    getLimit(planId: string): Promise<number>;
+}
+/**
+ * Options for {@link createSettingsHandler}.
+ */
+export interface SettingsHandlerOptions {
+    /** API key storage service. */
+    apiKeyService: ApiKeyService;
+    /** Billing service for usage and subscription queries. */
+    billing: SettingsBillingService;
+    /** Storage tracking service for instant usage queries. */
+    storageTracker: StorageTracker;
+    /** Storage limit resolver for plan-based limits. */
+    storageLimitResolver: StorageLimitResolver;
+}
+/**
+ * Creates the `settings` namespace handler.
+ *
+ * @param options - Settings handler dependencies.
+ * @returns A {@link NamespaceProvider} implementing {@link SettingsNamespace}.
+ */
+export declare function createSettingsHandler(options: SettingsHandlerOptions): NamespaceProvider;
+//# sourceMappingURL=settings.d.ts.map

package/dist/server/handlers/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,wBAAwB,CAAA;AAO/E;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAExG;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QACrE,OAAO,EAAE,OAAO,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAA;KACzD,CAAC,CAAA;IAEF,yBAAyB;IACzB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAE1F,gDAAgD;IAChD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5F,iEAAiE;IACjE,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACjE,mEAAmE;IACnE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAA;IAC9D,oDAAoD;IACpD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC1C;AAMD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,aAAa,EAAE,aAAa,CAAA;IAC5B,0DAA0D;IAC1D,OAAO,EAAE,sBAAsB,CAAA;IAC/B,0DAA0D;IAC1D,cAAc,EAAE,cAAc,CAAA;IAC9B,oDAAoD;IACpD,oBAAoB,EAAE,oBAAoB,CAAA;CAC3C;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,iBAAiB,CA6IxF"}

package/dist/server/handlers/settings.js

@@ -0,0 +1,131 @@
+/**
+ * @module server/handlers/settings
+ * @description Settings namespace handler — BYOK API key management, AI usage
+ * stats, and workspace storage usage.
+ *
+ * Absorbs Workshop `routes/settings.ts`. The handler delegates to injected
+ * service interfaces for API key storage, billing, and storage tracking, so
+ * products can plug in their own implementations.
+ *
+ * Methods:
+ * - `saveApiKey` — Save a BYOK API key (encrypted at rest)
+ * - `getApiKey` — Get redacted API key info
+ * - `deleteApiKey` — Delete a saved API key
+ * - `getUsageStats` — Get AI usage statistics for the billing period
+ * - `getStorageUsage` — Get storage consumption breakdown
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Handler factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates the `settings` namespace handler.
+ *
+ * @param options - Settings handler dependencies.
+ * @returns A {@link NamespaceProvider} implementing {@link SettingsNamespace}.
+ */
+export function createSettingsHandler(options) {
+    const { apiKeyService, billing, storageTracker, storageLimitResolver } = options;
+    return {
+        /**
+         * Save a BYOK API key, encrypted at rest.
+         *
+         * @param keyOptions - Provider name and raw key string.
+         * @param ctx - Handler context with authenticated user.
+         */
+        async saveApiKey(keyOptions, ctx) {
+            const { provider, key } = keyOptions;
+            if (!apiKeyService.isValidKey(key)) {
+                throw new Error('Invalid API key format');
+            }
+            const result = await apiKeyService.saveKey(ctx.user.emailHash, provider, key);
+            if (!result.success) {
+                throw new Error(result.error || 'Failed to save API key');
+            }
+        },
+        /**
+         * Get redacted API key information.
+         *
+         * @param provider - AI provider name (e.g. `'anthropic'`).
+         * @param ctx - Handler context with authenticated user.
+         * @returns Redacted key info or `null` if no key is saved.
+         */
+        async getApiKey(provider, ctx) {
+            const result = await apiKeyService.getKey(ctx.user.emailHash, ctx.workspaceId, provider);
+            // Only consider personal keys (workspace or global), not environment fallbacks
+            const isPersonalKey = result.source === 'workspace' || result.source === 'global';
+            if (!result.success || !result.apiKey || !isPersonalKey) {
+                return null;
+            }
+            return {
+                provider,
+                lastFour: result.apiKey.slice(-4),
+                createdAt: new Date().toISOString(), // Key service doesn't track creation date
+            };
+        },
+        /**
+         * Delete a saved API key.
+         *
+         * @param provider - AI provider whose key to delete.
+         * @param ctx - Handler context with authenticated user.
+         */
+        async deleteApiKey(provider, ctx) {
+            const result = await apiKeyService.deleteKey(ctx.user.emailHash, provider);
+            if (!result.success) {
+                throw new Error(result.error || 'Failed to delete API key');
+            }
+        },
+        /**
+         * Get AI usage statistics for the current billing period.
+         *
+         * @param ctx - Handler context with authenticated user.
+         * @returns Message count, token totals, and period identifier.
+         */
+        async getUsageStats(ctx) {
+            const billingId = ctx.user.email;
+            // Check if user has a personal key
+            const keyResult = await apiKeyService.getKey(ctx.user.emailHash, ctx.workspaceId, 'anthropic');
+            const hasPersonalKey = keyResult.success && keyResult.source === 'global';
+            const usageStatus = await billing.getUsageStatus(billingId, hasPersonalKey);
+            return {
+                messages: usageStatus.messages ?? 0,
+                tokens: {
+                    input: usageStatus.tokensIn ?? usageStatus.inputTokens ?? 0,
+                    output: usageStatus.tokensOut ?? usageStatus.outputTokens ?? 0,
+                },
+                period: usageStatus.period ?? new Date().toISOString().slice(0, 7),
+            };
+        },
+        /**
+         * Get storage consumption breakdown for the current workspace.
+         *
+         * Uses incremental storage tracking for instant response. On first access,
+         * forces a one-time initialization to ensure accurate data.
+         *
+         * @param ctx - Handler context with authenticated user and workspace.
+         * @returns Storage usage across entities, files, and indices.
+         */
+        async getStorageUsage(ctx) {
+            const storageId = ctx.user.emailHash;
+            const billingId = ctx.user.email;
+            // Get plan-based storage limit
+            const subscription = await billing.getSubscription(billingId);
+            const planId = subscription?.plan || 'free';
+            const limitBytes = await storageLimitResolver.getLimit(planId);
+            // Get current usage (instant from incremental tracker)
+            let usedBytes = await storageTracker.getUsage(storageId, ctx.workspaceId);
+            // Force init on first access for accuracy
+            if (!storageTracker.isInitialized(storageId, ctx.workspaceId)) {
+                usedBytes = await storageTracker.forceInit(storageId, ctx.workspaceId);
+            }
+            // The SDK contract returns a breakdown; we estimate the split from total.
+            // Products can override with more granular tracking if needed.
+            return {
+                totalBytes: usedBytes,
+                entityBytes: Math.round(usedBytes * 0.3), // Approximate: ~30% entities
+                fileBytes: Math.round(usedBytes * 0.6), // Approximate: ~60% files
+                indexBytes: Math.round(usedBytes * 0.1), // Approximate: ~10% indices
+            };
+        },
+    };
+}
+//# sourceMappingURL=settings.js.map

package/dist/server/handlers/settings.js.map

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

package/dist/server/handlers/workspace.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @module server/handlers/workspace
+ * @description Workspace namespace handler — workspace CRUD, backup/restore,
+ * Venue connection, health checks, and workspace settings.
+ *
+ * Absorbs Workshop `routes/workspace.ts` (backup/restore, SSE events, whoami)
+ * and `routes/workspaces.ts` (CRUD, validation, connect-venue, available-venues).
+ *
+ * The handler delegates to an injected `WorkspaceManager` interface for workspace
+ * registry operations, so products can plug in their own storage backends.
+ *
+ * Methods:
+ * - `list` — List all workspaces for the current user
+ * - `get` — Get a specific workspace by ID
+ * - `create` — Create a new workspace (optionally from a kit)
+ * - `update` — Update workspace metadata
+ * - `delete` — Delete a workspace permanently
+ * - `getStatus` — Get workspace health and initialization status
+ * - `backup` — Create a downloadable backup archive
+ * - `restore` — Restore from a backup archive
+ * - `connectVenue` — Connect workspace to a Venue site
+ * - `getSettings` — Get workspace-level settings
+ * - `updateSettings` — Update workspace settings (merge)
+ * - `healthCheck` — Brainy round-trip health check
+ */
+import type { NamespaceProvider } from '../namespace-router.js';
+import type { WorkspaceInfo } from '../../namespaces.js';
+/**
+ * Workspace registry manager — provides workspace CRUD without Hono coupling.
+ *
+ * Products implement this interface to connect to their workspace storage.
+ * Workshop uses a JSON file registry on the filesystem; Venue might use a
+ * database-backed registry.
+ */
+export interface WorkspaceManager {
+    /** List all workspaces for the given user. */
+    listWorkspaces(userId: string): Promise<WorkspaceInfo[]>;
+    /** Get a workspace by ID. Returns `null` if not found. */
+    getWorkspace(userId: string, workspaceId: string): Promise<WorkspaceInfo | null>;
+    /** Create a new workspace. */
+    createWorkspace(userId: string, options: {
+        name: string;
+        kitId?: string;
+        description?: string;
+        color?: string;
+        icon?: string;
+    }): Promise<WorkspaceInfo>;
+    /** Update workspace metadata. */
+    updateWorkspace(userId: string, workspaceId: string, updates: {
+        name?: string;
+    }): Promise<WorkspaceInfo>;
+    /** Delete a workspace. */
+    deleteWorkspace(userId: string, workspaceId: string): Promise<void>;
+    /**
+     * Connect workspace to a Venue site.
+     *
+     * @param userId - User's email hash.
+     * @param venueUrl - Venue base URL.
+     * @param locationId - Venue location ID.
+     * @returns Connection metadata for the remote workspace.
+     */
+    connectVenue?(userId: string, venueUrl: string, locationId: string): Promise<WorkspaceInfo>;
+}
+/**
+ * Options for {@link createWorkspaceHandler}.
+ */
+export interface WorkspaceHandlerOptions {
+    /** Workspace registry manager. */
+    workspaceManager: WorkspaceManager;
+}
+/**
+ * Creates the `workspace` namespace handler.
+ *
+ * @param options - Workspace handler dependencies.
+ * @returns A {@link NamespaceProvider} implementing {@link WorkspaceNamespace}.
+ */
+export declare function createWorkspaceHandler(options: WorkspaceHandlerOptions): NamespaceProvider;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/server/handlers/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,wBAAwB,CAAA;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,qBAAqB,CAAA;AAMzE;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IAExD,0DAA0D;IAC1D,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAEhF,8BAA8B;IAC9B,eAAe,CACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7F,OAAO,CAAC,aAAa,CAAC,CAAA;IAEzB,iCAAiC;IACjC,eAAe,CACb,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACzB,OAAO,CAAC,aAAa,CAAC,CAAA;IAEzB,0BAA0B;IAC1B,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnE;;;;;;;OAOG;IACH,YAAY,CAAC,CACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,gBAAgB,EAAE,gBAAgB,CAAA;CACnC;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,iBAAiB,CAkR1F"}

package/dist/server/handlers/workspace.js

@@ -0,0 +1,270 @@
+/**
+ * @module server/handlers/workspace
+ * @description Workspace namespace handler — workspace CRUD, backup/restore,
+ * Venue connection, health checks, and workspace settings.
+ *
+ * Absorbs Workshop `routes/workspace.ts` (backup/restore, SSE events, whoami)
+ * and `routes/workspaces.ts` (CRUD, validation, connect-venue, available-venues).
+ *
+ * The handler delegates to an injected `WorkspaceManager` interface for workspace
+ * registry operations, so products can plug in their own storage backends.
+ *
+ * Methods:
+ * - `list` — List all workspaces for the current user
+ * - `get` — Get a specific workspace by ID
+ * - `create` — Create a new workspace (optionally from a kit)
+ * - `update` — Update workspace metadata
+ * - `delete` — Delete a workspace permanently
+ * - `getStatus` — Get workspace health and initialization status
+ * - `backup` — Create a downloadable backup archive
+ * - `restore` — Restore from a backup archive
+ * - `connectVenue` — Connect workspace to a Venue site
+ * - `getSettings` — Get workspace-level settings
+ * - `updateSettings` — Update workspace settings (merge)
+ * - `healthCheck` — Brainy round-trip health check
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Handler factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates the `workspace` namespace handler.
+ *
+ * @param options - Workspace handler dependencies.
+ * @returns A {@link NamespaceProvider} implementing {@link WorkspaceNamespace}.
+ */
+export function createWorkspaceHandler(options) {
+    const { workspaceManager } = options;
+    return {
+        /**
+         * List all workspaces for the current user.
+         *
+         * @param ctx - Handler context with authenticated user.
+         * @returns Array of workspace metadata.
+         */
+        async list(ctx) {
+            return workspaceManager.listWorkspaces(ctx.user.emailHash);
+        },
+        /**
+         * Get a specific workspace by ID.
+         *
+         * @param workspaceId - The workspace's unique identifier.
+         * @param ctx - Handler context with authenticated user.
+         * @returns Workspace metadata or `null` if not found.
+         */
+        async get(workspaceId, ctx) {
+            return workspaceManager.getWorkspace(ctx.user.emailHash, workspaceId);
+        },
+        /**
+         * Create a new workspace, optionally from a kit template.
+         *
+         * @param createOptions - Workspace creation options.
+         * @param ctx - Handler context with authenticated user.
+         * @returns The newly created workspace metadata.
+         */
+        async create(createOptions, ctx) {
+            return workspaceManager.createWorkspace(ctx.user.emailHash, createOptions);
+        },
+        /**
+         * Update workspace metadata.
+         *
+         * @param workspaceId - Workspace to update.
+         * @param updates - Fields to update.
+         * @param ctx - Handler context with authenticated user.
+         * @returns The updated workspace metadata.
+         */
+        async update(workspaceId, updates, ctx) {
+            return workspaceManager.updateWorkspace(ctx.user.emailHash, workspaceId, updates);
+        },
+        /**
+         * Delete a workspace and all its data permanently.
+         *
+         * @param workspaceId - Workspace to delete.
+         * @param ctx - Handler context with authenticated user.
+         */
+        async delete(workspaceId, ctx) {
+            await workspaceManager.deleteWorkspace(ctx.user.emailHash, workspaceId);
+        },
+        /**
+         * Get the workspace's health and initialization status.
+         *
+         * Pings the Brainy instance with `indexStats()` to verify it's responsive.
+         *
+         * @param ctx - Handler context with Brainy instance.
+         * @returns Status and entity count.
+         */
+        async getStatus(ctx) {
+            try {
+                const stats = await ctx.brain.indexStats();
+                return {
+                    status: 'ready',
+                    workspaceId: ctx.workspaceId,
+                    entityCount: stats.entities ?? 0,
+                };
+            }
+            catch (err) {
+                return {
+                    status: 'error',
+                    workspaceId: ctx.workspaceId,
+                    error: err.message,
+                };
+            }
+        },
+        /**
+         * Create a downloadable backup of the entire workspace.
+         *
+         * Exports all VFS files and entities into a zip archive. The archive is
+         * returned as raw binary data (Uint8Array) that the transport layer
+         * converts to a download response.
+         *
+         * @param ctx - Handler context with Brainy instance.
+         * @returns Backup archive metadata with download URL placeholder.
+         */
+        async backup(ctx) {
+            const { brain } = ctx;
+            // Collect all VFS files
+            const vfsFiles = [];
+            try {
+                const allFiles = await brain.vfs.readdir('/', { recursive: true });
+                for (const file of allFiles) {
+                    try {
+                        const content = await brain.vfs.readFile(file.path);
+                        if (content !== null && content !== undefined) {
+                            vfsFiles.push({
+                                path: file.path,
+                                content: typeof content === 'string' ? content : JSON.stringify(content),
+                            });
+                        }
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+            }
+            catch {
+                // Empty VFS
+            }
+            // Export all entities
+            let entities = [];
+            try {
+                entities = await brain.find({ limit: 50000, excludeVFS: true });
+            }
+            catch {
+                // No entities
+            }
+            // Build manifest
+            const manifest = {
+                version: 1,
+                format: 'workshop-backup',
+                createdAt: new Date().toISOString(),
+                workspaceId: ctx.workspaceId,
+                fileCount: vfsFiles.length,
+                entityCount: entities.length,
+            };
+            // Estimate size (actual zip would be smaller)
+            const estimatedSize = vfsFiles.reduce((sum, f) => sum + f.content.length, 0)
+                + JSON.stringify(entities).length
+                + JSON.stringify(manifest).length;
+            // The actual zip creation happens at the transport/route level since it
+            // requires streaming binary data. The handler provides the data; the
+            // Hono route adapter assembles the archive.
+            // For now, return a placeholder that the Hono adapter interprets.
+            return {
+                downloadUrl: `__backup__:${ctx.workspaceId}`,
+                size: estimatedSize,
+            };
+        },
+        /**
+         * Restore a workspace from a backup archive.
+         *
+         * Processes the backup zip, restoring VFS files and entities into the
+         * current Brainy instance.
+         *
+         * @param backupData - The backup archive as raw binary data.
+         * @param ctx - Handler context with Brainy instance.
+         * @returns Counts of restored items.
+         */
+        async restore(backupData, ctx) {
+            const { brain } = ctx;
+            // Restore requires zip processing — delegated to the transport/route layer
+            // for binary handling. The core logic is:
+            // 1. Parse manifest.json from zip
+            // 2. Restore vfs/ entries via brain.vfs.writeFile()
+            // 3. Restore data/entities.json via brain.add()
+            // This will be fully wired when the Hono adapter handles multipart uploads.
+            throw new Error('workspace.restore requires binary transport — use the Hono route adapter');
+        },
+        /**
+         * Connect the workspace to a Venue site.
+         *
+         * @param venueOptions - Venue handle and slug.
+         * @param ctx - Handler context with authenticated user.
+         */
+        async connectVenue(venueOptions, ctx) {
+            if (!workspaceManager.connectVenue) {
+                throw new Error('Venue connection is not configured for this product');
+            }
+            // Derive Venue URL from handle (products configure this)
+            const venueUrl = `https://${venueOptions.venueHandle}.soulcraft.com`;
+            await workspaceManager.connectVenue(ctx.user.emailHash, venueUrl, venueOptions.venueSlug);
+        },
+        /**
+         * Get workspace-level settings.
+         *
+         * Reads the `workshop.settings` extended attribute from the workspace root.
+         *
+         * @param ctx - Handler context with Brainy instance.
+         * @returns Key-value settings object.
+         */
+        async getSettings(ctx) {
+            try {
+                return (await ctx.brain.vfs.getxattr('/', 'workshop.settings')) || {};
+            }
+            catch {
+                return {};
+            }
+        },
+        /**
+         * Update workspace settings (merge).
+         *
+         * Merges the provided settings into the existing `workshop.settings` xattr.
+         *
+         * @param settings - Key-value pairs to merge.
+         * @param ctx - Handler context with Brainy instance.
+         */
+        async updateSettings(settings, ctx) {
+            let existing = {};
+            try {
+                existing = (await ctx.brain.vfs.getxattr('/', 'workshop.settings')) || {};
+            }
+            catch {
+                // No existing settings
+            }
+            await ctx.brain.vfs.setxattr('/', 'workshop.settings', { ...existing, ...settings });
+        },
+        /**
+         * Run a health check on the Brainy instance.
+         *
+         * Measures round-trip latency of an `indexStats()` call.
+         *
+         * @param ctx - Handler context with Brainy instance.
+         * @returns Health status and latency in milliseconds.
+         */
+        async healthCheck(ctx) {
+            const start = performance.now();
+            try {
+                await ctx.brain.indexStats();
+                return {
+                    status: 'ok',
+                    latencyMs: Math.round(performance.now() - start),
+                };
+            }
+            catch {
+                return {
+                    status: 'error',
+                    latencyMs: Math.round(performance.now() - start),
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/server/handlers/workspace.js.map

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

package/dist/server/hono-router.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @module server/hono-router
+ * @description Hono integration factory for the Soulcraft SDK namespace router.
+ *
+ * Creates a Hono app with three routes:
+ *
+ * - `POST /api/rpc` — Unified namespace RPC endpoint. Accepts the
+ *   {@link SoulcraftRPC} envelope and dispatches via the namespace router.
+ *   Streaming responses are delivered as SSE (`text/event-stream`).
+ *
+ * - `POST /api/brainy/rpc` — Legacy backward-compatible endpoint. Injects
+ *   `ns: 'brainy'` and forwards to the same namespace router.
+ *
+ * - `GET /api/events` — SSE subscription for real-time change events (TBD,
+ *   route registered but handler deferred to Phase 1b).
+ *
+ * Products mount this router in their Hono app with `app.route('', sdkRouter)`.
+ *
+ * @example Workshop server-hono.ts
+ * ```typescript
+ * import { createSoulcraftRouter } from '@soulcraft/sdk/server'
+ *
+ * const sdkRouter = createSoulcraftRouter({
+ *   resolveBrain: async (ctx) => getUserBrainy(ctx.user!.emailHash, ctx.workspaceId),
+ *   authenticate: async (ctx) => verifySession(ctx.request),
+ *   providers: {
+ *     chat: chatHandler,
+ *     graph: graphHandler,
+ *     search: searchHandler,
+ *   },
+ * })
+ *
+ * app.route('', sdkRouter)
+ * ```
+ */
+import { Hono } from 'hono';
+import type { NamespaceRouterConfig } from './namespace-router.js';
+/**
+ * Configuration for {@link createSoulcraftRouter}.
+ *
+ * Same as {@link NamespaceRouterConfig} — passed through to the namespace router.
+ */
+export type SoulcraftRouterConfig = NamespaceRouterConfig;
+/**
+ * Creates a Hono app with the unified Soulcraft RPC routes.
+ *
+ * The returned Hono app should be mounted at the root of your product server
+ * (not under a prefix) since it defines its own `/api/rpc` and `/api/brainy/rpc`
+ * paths.
+ *
+ * @param config - Namespace router configuration.
+ * @returns A Hono app ready to be mounted with `app.route('', sdkRouter)`.
+ *
+ * @example
+ * ```typescript
+ * const sdkRouter = createSoulcraftRouter({
+ *   resolveBrain: async (ctx) => pool.forUser(ctx.user!.emailHash, ctx.workspaceId),
+ *   authenticate: async (ctx) => verifySession(ctx.request),
+ *   providers: { chat: chatHandler },
+ * })
+ *
+ * app.route('', sdkRouter)
+ * ```
+ */
+export declare function createSoulcraftRouter(config: SoulcraftRouterConfig): Hono;
+//# sourceMappingURL=hono-router.d.ts.map