@soulcraft/sdk 1.6.2 → 2.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"hono-router.d.ts","sourceRoot":"","sources":["../../src/server/hono-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B,OAAO,KAAK,EAAE,qBAAqB,EAAkB,MAAM,uBAAuB,CAAA;AAGlF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,CAAA;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAyFzE"}

package/dist/server/hono-router.js

@@ -0,0 +1,203 @@
+/**
+ * @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 { createNamespaceRouter } from './namespace-router.js';
+/**
+ * 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 function createSoulcraftRouter(config) {
+    const router = createNamespaceRouter(config);
+    const app = new Hono();
+    // ── POST /api/rpc — Unified namespace RPC ────────────────────────────────
+    app.post('/api/rpc', async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: { code: 'BAD_REQUEST', message: 'Request body must be valid JSON' } }, 400);
+        }
+        // Validate required fields.
+        if (typeof body.ns !== 'string' || typeof body.method !== 'string' || !Array.isArray(body.args)) {
+            return c.json({ error: { code: 'BAD_REQUEST', message: '{ ns: string, method: string, args: unknown[] } required' } }, 400);
+        }
+        const rpc = {
+            id: typeof body.id === 'string' ? body.id : crypto.randomUUID(),
+            ns: body.ns,
+            method: body.method,
+            args: body.args,
+            stream: body.stream ?? false,
+        };
+        const result = await router.dispatch(rpc, c.req.raw);
+        return _sendResult(c, result);
+    });
+    // ── POST /api/brainy/rpc — Legacy backward-compat ─────────────────────────
+    app.post('/api/brainy/rpc', async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: { code: 'BAD_REQUEST', message: 'Request body must be valid JSON' } }, 400);
+        }
+        if (typeof body.method !== 'string' || !Array.isArray(body.args)) {
+            return c.json({ error: { code: 'BAD_REQUEST', message: '{ method: string, args: unknown[] } required' } }, 400);
+        }
+        // Inject ns: 'brainy' for legacy callers.
+        // If the method starts with 'vfs.' or 'versions.', promote to the sub-namespace.
+        let ns = 'brainy';
+        let method = body.method;
+        for (const prefix of ['vfs.', 'versions.']) {
+            if (method.startsWith(prefix)) {
+                ns = `brainy.${prefix.slice(0, -1)}`;
+                method = method.slice(prefix.length);
+                break;
+            }
+        }
+        const rpc = {
+            id: crypto.randomUUID(),
+            ns,
+            method,
+            args: body.args,
+        };
+        const result = await router.dispatch(rpc, c.req.raw);
+        return _sendResult(c, result);
+    });
+    // ── GET /api/events — SSE subscription (placeholder for Phase 1b) ────────
+    app.get('/api/events', (c) => {
+        // SSE event stream — implemented in Phase 1b when event handlers are ready.
+        return c.text('SSE endpoint registered — handler deferred to Phase 1b', 501);
+    });
+    return app;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Response helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Converts a {@link DispatchResult} into a Hono Response.
+ *
+ * For `response` results, returns JSON.
+ * For `stream` results, returns an SSE stream.
+ *
+ * @param c - Hono context.
+ * @param result - The dispatch result from the namespace router.
+ * @returns A Response.
+ */
+function _sendResult(c, result) {
+    if (result.type === 'response') {
+        const { response } = result;
+        const status = response.error ? _errorStatusCode(response.error.code) : 200;
+        return new Response(JSON.stringify(response), {
+            status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
+    // Streaming result — deliver as SSE.
+    const { id, iterable } = result;
+    const stream = new ReadableStream({
+        async start(controller) {
+            const encoder = new TextEncoder();
+            try {
+                for await (const chunk of iterable) {
+                    const frame = { id, chunk };
+                    controller.enqueue(encoder.encode(`data: ${JSON.stringify(frame)}\n\n`));
+                }
+                // Send done signal.
+                const doneFrame = { id, done: true };
+                controller.enqueue(encoder.encode(`data: ${JSON.stringify(doneFrame)}\n\n`));
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                const errorFrame = { id, error: message };
+                controller.enqueue(encoder.encode(`data: ${JSON.stringify(errorFrame)}\n\n`));
+            }
+            finally {
+                controller.close();
+            }
+        },
+    });
+    return new Response(stream, {
+        status: 200,
+        headers: {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+        },
+    });
+}
+/**
+ * Maps error codes to HTTP status codes for JSON responses.
+ *
+ * @param code - The error code from the RPC response.
+ * @returns The appropriate HTTP status code.
+ */
+function _errorStatusCode(code) {
+    switch (code) {
+        case 'UNAUTHORIZED':
+        case 'AUTH_ERROR':
+            return 401;
+        case 'FORBIDDEN':
+            return 403;
+        case 'NAMESPACE_NOT_FOUND':
+        case 'METHOD_NOT_FOUND':
+            return 404;
+        case 'BRAIN_UNAVAILABLE':
+            return 503;
+        case 'BAD_REQUEST':
+            return 400;
+        default:
+            return 500;
+    }
+}
+//# sourceMappingURL=hono-router.js.map

package/dist/server/hono-router.js.map

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

package/dist/server/index.d.ts

@@ -3,32 +3,32 @@
  * @description Server entry point for @soulcraft/sdk. Exports everything needed to
  * run the SDK in a product backend (Hono, SvelteKit, or any Bun/Node server).
  *
- * Includes: Brainy instance pool, HTTP and WebSocket RPC handler factories, and
- * capability token utilities.
+ * ## SDK 2.0 — Namespace router (recommended)
+ *
+ * Use `createSoulcraftRouter()` to mount a single Hono router that handles ALL
+ * 25 SDK namespaces via a unified `/api/rpc` endpoint. Products configure which
+ * namespaces are active via `NamespaceProviders`.
+ *
+ * ## Legacy — Brainy-only handlers
+ *
+ * `createBrainyHandler()` and `createBrainyWsHandler()` still work for backward
+ * compatibility but only handle the `brainy` namespace.
  *
  * This entry point must never be imported in browser bundles — it has hard
  * server-only dependencies (`@soulcraft/brainy`, `lru-cache`, `crypto`, `fs`).
  *
- * @example Workshop server setup
+ * @example SDK 2.0 — unified router
  * ```typescript
- * import { BrainyInstancePool, createBrainyHandler, createBrainyWsHandler, computeEmailHash } from '@soulcraft/sdk/server'
- * import { verifyCapabilityToken } from '@soulcraft/sdk'
+ * import { createSoulcraftRouter, BrainyInstancePool } from '@soulcraft/sdk/server'
  *
- * const pool = new BrainyInstancePool({
- *   storage: 'mmap-filesystem',
- *   dataPath: '/mnt/brainy-data',
- *   strategy: 'per-user',
- *   maxInstances: 200,
- * })
+ * const pool = new BrainyInstancePool({ storage: 'filesystem', dataPath: './data', strategy: 'per-user' })
  *
- * const rpcHandler = createBrainyHandler({
- *   resolveBrain: (req) => {
- *     const userId = req.headers.get('x-email-hash') ?? ''
- *     const workspaceId = req.headers.get('x-workspace-id') ?? ''
- *     return pool.forUser(userId, workspaceId)
- *   },
- *   authenticate: (req) => verifySession(req.headers.get('cookie') ?? ''),
+ * const router = createSoulcraftRouter({
+ *   resolveBrain: async (ctx) => pool.forUser(ctx.user.emailHash, ctx.workspaceId),
+ *   authenticate: async (ctx) => verifySession(ctx.request),
+ *   providers: { ai: { client: anthropic }, billing, hall, ... },
  * })
+ * app.route('', router)
  * ```
  */
 export { BrainyInstancePool, computeEmailHash, } from './instance-pool.js';
@@ -47,6 +47,8 @@ export { createBackchannelLogoutHandler } from '../modules/auth/backchannel.js';
 export type { BackchannelLogoutConfig, BackchannelAuthLike, } from '../modules/auth/backchannel.js';
 export { verifyServiceToken, extractBearerToken, } from '../modules/auth/service-token.js';
 export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, getAuthMode, getOIDCClientConfig, } from '../modules/auth/config.js';
+export { SOULCRAFT_PRODUCTS, deriveOrigins, deriveRedirectUrls, } from '../modules/auth/products.js';
+export type { ProductRegistration, SoulcraftProduct, } from '../modules/auth/products.js';
 export { createSDK } from './create-sdk.js';
 export type { CreateSDKOptions } from './create-sdk.js';
 export { createServerSDK } from './from-license.js';
@@ -57,8 +59,16 @@ export { createLicenseModule } from '../modules/license/index.js';
 export type { CreateLicenseModuleOptions } from '../modules/license/index.js';
 export { createKitsModule } from '../modules/kits/index.js';
 export { createNotificationsModule } from '../modules/notifications/index.js';
-export type { ServerSDKOptions } from '../types.js';
+export type { SoulcraftSDK, ServerSDKOptions } from '../types.js';
+export type { SoulcraftNamespaces } from '../namespaces.js';
 export { createCapabilityToken, verifyCapabilityToken } from '../modules/brainy/auth.js';
 export type { CreateCapabilityTokenOptions, CapabilityTokenClaims } from '../modules/brainy/auth.js';
 export { LocalTransport } from '../transports/local.js';
+export { createNamespaceRouter } from './namespace-router.js';
+export type { NamespaceRouterConfig, NamespaceRouter, NamespaceProvider, NamespaceProviders, RequestContext, UserContext, HandlerContext, DispatchResult, } from './namespace-router.js';
+export { createSoulcraftRouter } from './hono-router.js';
+export type { SoulcraftRouterConfig } from './hono-router.js';
+export { createAnnotationsHandler, createAuthHandler, createChatHandler, createCertificationHandler, createCollectionsHandler, createCommerceHandler, createConfigHandler, createExportHandler, createFormatsHandler, createGraphHandler, createImportHandler, createMediaHandler, createProjectHandler, createPublishHandler, createPulseHandler, createRealtimeHandler, createSearchHandler, createSessionHandler, createSettingsHandler, createWorkspaceHandler, } from './handlers/index.js';
+export type { AnnotationAiClient, AnnotationsHandlerOptions, ChatHandlerOptions, ChatAIClient, AnthropicStreamEvent, ToolDefinition, ToolExecutor, ToolExecutionContext, SystemPromptBuilder, SystemPromptContext, ChatBillingCheck, ChatEventEmitter, ModelSelector, TieredRouting, RetrievedMemory, UserExpertiseProfile, AIPlan, PlanStep, StepProgress, PlanExecutionResult, CapabilityTokenFactory, AuthHandlerOptions, SampleDataProvider, CollectionsHandlerOptions, PaymentProvider, CommerceHandlerOptions, ConfigService, ConfigBillingService, ConfigHandlerOptions, ExportPipeline, ExportHandlerOptions, FormatConverter, FormatsHandlerOptions, ImportPipeline, ImportHandlerOptions, MediaBackend, MediaHandlerOptions, KitLoader, ProjectHandlerOptions, PublishBackend, VenueDeployService, AcademyPublishService, PublishHandlerOptions, PulseHandlerOptions, RealtimeBackend, RealtimeHandlerOptions, SessionEventEmitter, SessionHandlerOptions, ApiKeyService, SettingsBillingService, StorageTracker, StorageLimitResolver, SettingsHandlerOptions, WorkspaceManager, WorkspaceHandlerOptions, } from './handlers/index.js';
+export { analyzeComplexity, calculateComplexityScore, selectTieredRouting, createDefaultModelSelector, estimateCost, formatCost, DEFAULT_MODELS, DEFAULT_MODEL_TIERS, streamMessage, sendMessage, } from './handlers/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,SAAS,GACV,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAG/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAA;AACzE,YAAY,EACV,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,GACX,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,qBAAqB,EACrB,UAAU,EACV,qBAAqB,EACrB,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,QAAQ,EACR,cAAc,EACd,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,GACd,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,GACd,MAAM,+BAA+B,CAAA;AACtC,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAA;AAC/E,YAAY,EACV,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,gCAAgC,CAAA;AAGvC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kCAAkC,CAAA;AAGzC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,EACX,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAGlC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAG7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACxF,YAAY,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"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"}

package/dist/server/index.js

@@ -3,32 +3,32 @@
  * @description Server entry point for @soulcraft/sdk. Exports everything needed to
  * run the SDK in a product backend (Hono, SvelteKit, or any Bun/Node server).
  *
- * Includes: Brainy instance pool, HTTP and WebSocket RPC handler factories, and
- * capability token utilities.
+ * ## SDK 2.0 — Namespace router (recommended)
+ *
+ * Use `createSoulcraftRouter()` to mount a single Hono router that handles ALL
+ * 25 SDK namespaces via a unified `/api/rpc` endpoint. Products configure which
+ * namespaces are active via `NamespaceProviders`.
+ *
+ * ## Legacy — Brainy-only handlers
+ *
+ * `createBrainyHandler()` and `createBrainyWsHandler()` still work for backward
+ * compatibility but only handle the `brainy` namespace.
  *
  * This entry point must never be imported in browser bundles — it has hard
  * server-only dependencies (`@soulcraft/brainy`, `lru-cache`, `crypto`, `fs`).
  *
- * @example Workshop server setup
+ * @example SDK 2.0 — unified router
  * ```typescript
- * import { BrainyInstancePool, createBrainyHandler, createBrainyWsHandler, computeEmailHash } from '@soulcraft/sdk/server'
- * import { verifyCapabilityToken } from '@soulcraft/sdk'
- *
- * const pool = new BrainyInstancePool({
- *   storage: 'mmap-filesystem',
- *   dataPath: '/mnt/brainy-data',
- *   strategy: 'per-user',
- *   maxInstances: 200,
- * })
+ * import { createSoulcraftRouter, BrainyInstancePool } from '@soulcraft/sdk/server'
+ *
+ * const pool = new BrainyInstancePool({ storage: 'filesystem', dataPath: './data', strategy: 'per-user' })
  *
- * const rpcHandler = createBrainyHandler({
- *   resolveBrain: (req) => {
- *     const userId = req.headers.get('x-email-hash') ?? ''
- *     const workspaceId = req.headers.get('x-workspace-id') ?? ''
- *     return pool.forUser(userId, workspaceId)
- *   },
- *   authenticate: (req) => verifySession(req.headers.get('cookie') ?? ''),
+ * const router = createSoulcraftRouter({
+ *   resolveBrain: async (ctx) => pool.forUser(ctx.user.emailHash, ctx.workspaceId),
+ *   authenticate: async (ctx) => verifySession(ctx.request),
+ *   providers: { ai: { client: anthropic }, billing, hall, ... },
  * })
+ * app.route('', router)
  * ```
  */
 // ── Instance pool ─────────────────────────────────────────────────────────────
@@ -48,6 +48,8 @@ export { createBackchannelLogoutHandler } from '../modules/auth/backchannel.js';
 export { verifyServiceToken, extractBearerToken, } from '../modules/auth/service-token.js';
 // ── Auth config helpers (also on shared entry, duplicated here for convenience) ─
 export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, getAuthMode, getOIDCClientConfig, } from '../modules/auth/config.js';
+// ── Product registry — single source of truth for all Soulcraft products ─────
+export { SOULCRAFT_PRODUCTS, deriveOrigins, deriveRedirectUrls, } from '../modules/auth/products.js';
 // ── createSDK factory ─────────────────────────────────────────────────────────
 export { createSDK } from './create-sdk.js';
 // ── createServerSDK.fromLicense() — license-driven server SDK ─────────────────
@@ -59,4 +61,16 @@ export { createKitsModule } from '../modules/kits/index.js';
 export { createNotificationsModule } from '../modules/notifications/index.js';
 export { createCapabilityToken, verifyCapabilityToken } from '../modules/brainy/auth.js';
 export { LocalTransport } from '../transports/local.js';
+// ── Namespace router (Symmetrical SDK 2.0) ──────────────────────────────────
+export { createNamespaceRouter } from './namespace-router.js';
+// ── Hono router factory (Symmetrical SDK 2.0) ──────────────────────────────
+export { createSoulcraftRouter } from './hono-router.js';
+// ── Namespace handler factories (Symmetrical SDK 2.0) ───────────────────────
+// Each factory creates a NamespaceProvider wired into `providers` on the router.
+export { 
+// Handler factories
+createAnnotationsHandler, createAuthHandler, createChatHandler, createCertificationHandler, createCollectionsHandler, createCommerceHandler, createConfigHandler, createExportHandler, createFormatsHandler, createGraphHandler, createImportHandler, createMediaHandler, createProjectHandler, createPublishHandler, createPulseHandler, createRealtimeHandler, createSearchHandler, createSessionHandler, createSettingsHandler, createWorkspaceHandler, } from './handlers/index.js';
+export { 
+// Chat engine utilities
+analyzeComplexity, calculateComplexityScore, selectTieredRouting, createDefaultModelSelector, estimateCost, formatCost, DEFAULT_MODELS, DEFAULT_MODEL_TIERS, streamMessage, sendMessage, } from './handlers/index.js';
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,iFAAiF;AACjF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAM3B,iFAAiF;AACjF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAA;AAQtB,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAE/D,iFAAiF;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAA;AAMzE,gFAAgF;AAChF,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,GACX,MAAM,oBAAoB,CAAA;AAqB3B,iFAAiF;AACjF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,GACd,MAAM,+BAA+B,CAAA;AAYtC,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAA;AAM/E,iFAAiF;AACjF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kCAAkC,CAAA;AAEzC,mFAAmF;AACnF,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,EACX,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAElC,iFAAiF;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3C,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAQnD,qFAAqF;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAI7E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAExF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,iFAAiF;AACjF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAM3B,iFAAiF;AACjF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAA;AAQtB,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAE/D,iFAAiF;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAA;AAMzE,gFAAgF;AAChF,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,GACX,MAAM,oBAAoB,CAAA;AAqB3B,iFAAiF;AACjF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,GACd,MAAM,+BAA+B,CAAA;AAYtC,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAA;AAM/E,iFAAiF;AACjF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kCAAkC,CAAA;AAEzC,mFAAmF;AACnF,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,EACX,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAElC,gFAAgF;AAChF,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,kBAAkB,GACnB,MAAM,6BAA6B,CAAA;AAMpC,iFAAiF;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3C,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAQnD,qFAAqF;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAK7E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAExF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD,+EAA+E;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAY7D,8EAA8E;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAGxD,+EAA+E;AAC/E,iFAAiF;AACjF,OAAO;AACL,oBAAoB;AACpB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,qBAAqB,CAAA;AA2D5B,OAAO;AACL,wBAAwB;AACxB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,YAAY,EACZ,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAA"}

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

@@ -0,0 +1,204 @@
+/**
+ * @module server/namespace-router
+ * @description Universal namespace-aware RPC dispatcher for the Soulcraft SDK.
+ *
+ * Receives requests in the {@link SoulcraftRPC} envelope format, authenticates the
+ * caller, resolves the target namespace, and dispatches to the appropriate handler.
+ *
+ * ## Dispatch model
+ *
+ * - `brainy` / `brainy.vfs` / `brainy.versions` → {@link LocalTransport} dispatch
+ *   against the resolved Brainy instance (same proven RPC path as SDK 1.x).
+ * - All other namespaces → provider-based dispatch. Each namespace's provider is a
+ *   plain object whose methods match the namespace contract in `namespaces.ts`.
+ *
+ * ## Streaming
+ *
+ * When `stream: true` is set on the request, the handler is expected to return an
+ * `AsyncIterable`. The router converts each yielded value into a
+ * {@link SoulcraftRPCStream} frame and delivers it via the transport-appropriate
+ * mechanism (SSE, PostMessage chunks, or WebSocket frames).
+ *
+ * ## Error handling
+ *
+ * All errors are caught at the dispatch level and returned as `SoulcraftRPCResponse`
+ * with an `error` field. Handler code does not need to wrap logic in try/catch.
+ *
+ * @example Hono integration
+ * ```typescript
+ * import { createNamespaceRouter } from '@soulcraft/sdk/server'
+ *
+ * const router = createNamespaceRouter({
+ *   resolveBrain: async (ctx) => pool.forUser(ctx.userId, ctx.workspaceId),
+ *   authenticate: async (ctx) => verifySession(ctx.request),
+ *   providers: { chat: chatProvider, graph: graphProvider },
+ * })
+ *
+ * const response = await router.dispatch({ ns: 'brainy', method: 'find', args: [...] }, requestContext)
+ * ```
+ */
+import type { Brainy } from '@soulcraft/brainy';
+import type { SoulcraftRPC, SoulcraftRPCResponse } from '../rpc.js';
+/**
+ * Context extracted from an incoming request. Passed to `authenticate` and
+ * `resolveBrain` callbacks so they can inspect headers, cookies, etc.
+ */
+export interface RequestContext {
+    /** The raw HTTP Request (for header inspection). */
+    request: Request;
+    /** User identity populated by `authenticate()`. `null` before auth. */
+    user: UserContext | null;
+    /** Workspace ID extracted from the `X-Workspace-Id` header or query param. */
+    workspaceId: string;
+}
+/**
+ * Authenticated user context returned by the `authenticate` callback.
+ */
+export interface UserContext {
+    /** Unique user identifier. */
+    id: string;
+    /** User's email address. */
+    email: string;
+    /** User's display name. */
+    name: string;
+    /** Email hash for per-user isolation. */
+    emailHash: string;
+    /** Platform role. */
+    role?: string | undefined;
+    /** Whether the user has a BYOK (Bring Your Own Key) API key. */
+    hasByok?: boolean | undefined;
+    /** Additional user fields passed through from the auth provider. */
+    [key: string]: unknown;
+}
+/**
+ * A namespace provider is a plain object whose methods match the corresponding
+ * namespace interface in `namespaces.ts`.
+ *
+ * Each method receives the RPC args array spread as positional params, plus
+ * a context object as the last argument for server-side operations that need
+ * the authenticated user or Brainy instance.
+ */
+export type NamespaceProvider = Record<string, ((...args: any[]) => any) | undefined>;
+/**
+ * Context passed to every namespace handler method.
+ *
+ * Providers use this to access the authenticated user, resolved Brainy instance,
+ * and workspace ID without needing to parse headers themselves.
+ */
+export interface HandlerContext {
+    /** The authenticated user. */
+    user: UserContext;
+    /** Workspace ID. */
+    workspaceId: string;
+    /** Brainy instance for this request (resolved lazily on first access). */
+    brain: Brainy;
+    /** The raw HTTP request (for advanced cases). */
+    request: Request;
+}
+/**
+ * Registry of namespace providers. Keys are namespace names (e.g. `'chat'`,
+ * `'graph'`), values are provider objects.
+ *
+ * The `brainy` namespace does NOT need a provider — it is handled internally
+ * via `LocalTransport` dispatch against the resolved Brainy instance.
+ */
+export type NamespaceProviders = Record<string, NamespaceProvider | undefined>;
+/**
+ * Configuration for {@link createNamespaceRouter}.
+ */
+export interface NamespaceRouterConfig {
+    /**
+     * Resolves the Brainy instance for this request context.
+     *
+     * Called when the target namespace is `brainy`, `brainy.vfs`, or
+     * `brainy.versions`, or when a Tier 2 handler needs a brain instance.
+     *
+     * @param ctx - The request context with authenticated user and workspace ID.
+     * @returns The Brainy instance for this user + workspace.
+     */
+    resolveBrain: (ctx: RequestContext) => Promise<Brainy>;
+    /**
+     * Authenticates the incoming request.
+     *
+     * Called before any dispatch. Return a {@link UserContext} on success,
+     * or `null` to reject with 401.
+     *
+     * @param ctx - The request context with the raw HTTP request.
+     * @returns The authenticated user, or `null`.
+     */
+    authenticate: (ctx: RequestContext) => Promise<UserContext | null>;
+    /**
+     * Optional per-call authorization check.
+     *
+     * Called after authentication succeeds. Return `false` to reject with 403.
+     *
+     * @param ns - The target namespace.
+     * @param method - The method within the namespace.
+     * @param args - The call arguments.
+     * @param user - The authenticated user.
+     * @returns `true` to allow, `false` to deny.
+     */
+    authorize?: (ns: string, method: string, args: unknown[], user: UserContext) => Promise<boolean> | boolean;
+    /**
+     * Namespace providers — one per Tier 2 namespace.
+     * The `brainy` namespace is handled internally and does not need a provider.
+     */
+    providers: NamespaceProviders;
+    /**
+     * Brainy RPC methods that are blocked for all callers.
+     *
+     * @default []
+     */
+    blockedBrainyMethods?: string[];
+}
+/** Discriminated union of dispatch outcomes. */
+export type DispatchResult = {
+    type: 'response';
+    response: SoulcraftRPCResponse;
+} | {
+    type: 'stream';
+    id: string;
+    iterable: AsyncIterable<unknown>;
+};
+/**
+ * The namespace router returned by {@link createNamespaceRouter}.
+ */
+export interface NamespaceRouter {
+    /**
+     * Dispatch an RPC request through the namespace router.
+     *
+     * Handles authentication, authorization, namespace resolution, and error
+     * wrapping. Returns either a single response or a stream.
+     *
+     * @param rpc - The parsed RPC request envelope.
+     * @param request - The raw HTTP request for auth/header inspection.
+     * @returns A response or stream result.
+     */
+    dispatch(rpc: SoulcraftRPC, request: Request): Promise<DispatchResult>;
+}
+/**
+ * Creates a namespace-aware RPC router that dispatches to Brainy or provider
+ * handler methods based on the `ns` field in the request.
+ *
+ * @param config - Router configuration.
+ * @returns A {@link NamespaceRouter} with a `dispatch()` method.
+ *
+ * @example
+ * ```typescript
+ * const router = createNamespaceRouter({
+ *   resolveBrain: (ctx) => pool.forUser(ctx.user!.emailHash, ctx.workspaceId),
+ *   authenticate: (ctx) => verifySession(ctx.request),
+ *   providers: {
+ *     chat: chatHandler,
+ *     graph: graphHandler,
+ *   },
+ * })
+ *
+ * const result = await router.dispatch(
+ *   { id: '1', ns: 'brainy', method: 'find', args: [{ query: 'test' }] },
+ *   request,
+ * )
+ * ```
+ */
+export declare function createNamespaceRouter(config: NamespaceRouterConfig): NamespaceRouter;
+//# sourceMappingURL=namespace-router.d.ts.map

package/dist/server/namespace-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-router.d.ts","sourceRoot":"","sources":["../../src/server/namespace-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EAErB,MAAM,WAAW,CAAA;AAMlB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAA;IAChB,uEAAuE;IACvE,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,oEAAoE;IACpE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAMD;;;;;;;GAOG;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;AAErF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,EAAE,WAAW,CAAA;IACjB,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC,CAAA;AAM9E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;OAQG;IACH,YAAY,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAEtD;;;;;;;;OAQG;IACH,YAAY,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAElE;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,CACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IAE/B;;;OAGG;IACH,SAAS,EAAE,kBAAkB,CAAA;IAE7B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;CAChC;AAMD,gDAAgD;AAChD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;CAAE,CAAA;AAMpE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;OASG;IACH,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CACvE;AAuBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAqGpF"}