@soulcraft/sdk 1.7.0 → 2.0.0

package/dist/client/create-client-sdk.d.ts

@@ -69,8 +69,21 @@
  * sdk.brainy.onDataChange((event) => console.log('change:', event))
  * ```
  */
-import type { ClientSDKOptions } from '../types.js';
 import type { SoulcraftSDK } from '../types.js';
+/**
+ * Legacy client SDK options. Kept for backward compatibility with `createClientSDK()`.
+ * New code should use `createSoulcraftProxy()` with a namespace-aware transport instead.
+ */
+interface LegacyClientSDKOptions {
+    mode: 'client';
+    product: string;
+    transport: 'http' | 'ws' | 'sse';
+    baseUrl: string;
+    auth?: 'cookie' | {
+        token: string;
+    };
+    timeoutMs?: number;
+}
 /**
  * Create a client-mode `SoulcraftSDK` from the given options.
  *
@@ -95,5 +108,6 @@ import type { SoulcraftSDK } from '../types.js';
  * const results = await sdk.brainy.find({ query: 'candle inventory' })
  * ```
  */
-export declare function createClientSDK(options: ClientSDKOptions): SoulcraftSDK;
+export declare function createClientSDK(options: LegacyClientSDKOptions): SoulcraftSDK;
+export {};
 //# sourceMappingURL=create-client-sdk.d.ts.map

package/dist/client/create-client-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-client-sdk.d.ts","sourceRoot":"","sources":["../../src/client/create-client-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAA6B,MAAM,aAAa,CAAA;AAO1E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CA6EvE"}
+{"version":3,"file":"create-client-sdk.d.ts","sourceRoot":"","sources":["../../src/client/create-client-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG/C;;;GAGG;AACH,UAAU,sBAAsB;IAC9B,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAA;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,YAAY,CAwE7E"}

package/dist/client/create-client-sdk.js

@@ -120,15 +120,10 @@ export function createClientSDK(options) {
         transport = new HttpTransport(baseUrl, authToken, useCookies, timeoutMs);
     }
     const brainyProxy = createBrainyProxy(transport);
-    // VFS and versions are sub-namespaces of the Brainy proxy.
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const vfs = brainyProxy.vfs;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const versions = brainyProxy.versions;
+    // This legacy factory only wires the brainy namespace. All other namespaces
+    // throw at access time. For full namespace support, use createSoulcraftProxy().
     const sdk = {
         brainy: brainyProxy,
-        vfs,
-        versions,
         // Client mode stubs — these module namespaces are server-only.
         // Accessing them from a client app is a usage error; throw explicitly.
         get auth() {

package/dist/client/create-client-sdk.js.map

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

package/dist/client/index.d.ts

@@ -3,64 +3,69 @@
  * @description Browser/client entry point for @soulcraft/sdk. Exports everything needed
  * for kit apps running in a browser context to connect to a Soulcraft product backend.
  *
- * Includes: HTTP (JSON RPC), WebSocket (MessagePack binary RPC + change push), SSE
- * (server-push), and PostMessage (WebContainer iframe ↔ parent frame) transports.
- * Cookie-based and Bearer token auth. The Brainy proxy factory for creating a
- * fully-typed `sdk.brainy` API surface over any transport.
+ * ## SDK 2.0 — Namespace-aware transports (recommended)
  *
- * This entry point has no server-only dependencies — it is safe to bundle for the
- * browser. The trade-off is that it cannot create Brainy instances directly.
+ * Use `createSoulcraftProxy()` with a namespace-aware transport for full access to
+ * all 25 SDK namespaces (brainy, chat, graph, search, ai, media, realtime, etc.).
  *
- * @example HTTP transport (kit apps, stateless)
- * ```typescript
- * import { createBrainyProxy, HttpTransport } from '@soulcraft/sdk/client'
+ * - {@link HttpRpcTransport} — JSON POST to `/api/rpc`. Stateless, works everywhere.
+ * - {@link PostMessageRpcTransport} — `soulcraft:request` PostMessage. WebContainer iframes.
+ * - {@link WsTransport} — MessagePack binary over WebSocket. Real-time, bidirectional.
  *
- * const brainy = createBrainyProxy(
- *   new HttpTransport('https://workshop.soulcraft.com', undefined, true)
- * )
+ * ## Legacy transports (brainy-only)
  *
- * const results = await brainy.find({ query: 'candle kits', limit: 10 })
- * ```
+ * These transports only support the `brainy` namespace. They still work for backward
+ * compatibility but should be migrated to the namespace-aware transports above.
  *
- * @example WebSocket transport (real-time, change push)
- * ```typescript
- * import { createBrainyProxy, WsTransport } from '@soulcraft/sdk/client'
+ * - `LegacyHttpTransport` — `/api/brainy/rpc` only.
+ * - `LegacyPostMessageTransport` — `brainy:request` only.
+ * - `WorkshopTransport` — `workshop:request` non-brainy relay (superseded by PostMessageRpcTransport).
  *
- * const transport = new WsTransport(
- *   'wss://venue.soulcraft.com/api/brainy/ws',
- *   capabilityToken,
- *   'wicks-and-whiskers'
- * )
- * await transport.connect()
- *
- * const brainy = createBrainyProxy(transport)
- * brainy.onDataChange((event) => console.log('live change:', event))
+ * @example SDK 2.0 — full namespace access
+ * ```typescript
+ * import { createSoulcraftProxy, HttpRpcTransport } from '@soulcraft/sdk/client'
  *
- * const items = await brainy.find({ query: 'inventory' })
+ * const sdk = createSoulcraftProxy(new HttpRpcTransport('/api'))
+ * const results = await sdk.brainy.find({ query: 'candle kits' })
+ * const graph = await sdk.graph.getData()
  * ```
  *
- * @example SSE transport (receive-only change events, paired with HTTP)
+ * @example SDK 2.0 — PostMessage in WebContainer iframe
  * ```typescript
- * import { createBrainyProxy, HttpTransport, SseTransport } from '@soulcraft/sdk/client'
+ * import { createSoulcraftProxy, PostMessageRpcTransport } from '@soulcraft/sdk/client'
  *
- * const http = new HttpTransport('https://venue.soulcraft.com', undefined, true)
- * const sse = new SseTransport('https://venue.soulcraft.com', workspaceId)
- * sse.connect()
- *
- * const brainy = createBrainyProxy(http)
- * sse.onEvent((event) => refreshUI(event))
+ * const sdk = createSoulcraftProxy(new PostMessageRpcTransport(parentOrigin))
+ * const entities = await sdk.brainy.find({ query: 'notes' })
+ * for await (const chunk of sdk.chat.sendStreaming('Summarize my notes')) {
+ *   if (chunk.type === 'text') process.stdout.write(chunk.text!)
+ * }
  * ```
  */
+export { createSoulcraftProxy } from './namespace-proxy.js';
+export type { NamespaceTransport } from './namespace-proxy.js';
+export { HttpNamespaceTransport, PostMessageNamespaceTransport, HttpRpcTransport, PostMessageRpcTransport, } from '../transports/http-namespace.js';
+export type { HttpNamespaceTransportOptions } from '../transports/http-namespace.js';
 export { createClientSDK } from './create-client-sdk.js';
-export { HttpTransport } from '../transports/http.js';
+/**
+ * @deprecated Use {@link HttpRpcTransport} for full namespace support.
+ * This transport only supports the `brainy` namespace at `/api/brainy/rpc`.
+ */
+export { HttpTransport as LegacyHttpTransport } from '../transports/http.js';
+/**
+ * @deprecated Use {@link PostMessageRpcTransport} for full namespace support.
+ * This transport only supports `brainy:request` / `brainy:response`.
+ */
+export { PostMessageTransport as LegacyPostMessageTransport } from '../transports/postmessage.js';
 export { WsTransport } from '../transports/ws.js';
 export { SseTransport } from '../transports/sse.js';
-export { PostMessageTransport } from '../transports/postmessage.js';
 export type { PostMessageRequest, PostMessageResponse } from '../transports/postmessage.js';
 export type { SDKTransport } from '../transports/transport.js';
+/** @deprecated Use `createSoulcraftProxy()` for full namespace access. */
 export { createBrainyProxy } from '../modules/brainy/proxy.js';
+/** @deprecated Use `createSoulcraftProxy()` for full namespace access. */
 export { createAppContext } from '../modules/app-context/index.js';
 export type { CreateAppContextOptions, AppContext } from '../modules/app-context/index.js';
+/** @deprecated Use {@link PostMessageRpcTransport} which handles all namespaces. */
 export { WorkshopTransport } from '../transports/workshop.js';
 export type { WorkshopRequest, WorkshopResponse, WorkshopStreamChunk, } from '../transports/workshop.js';
 export { createYjsProvider } from '../transports/yjs-provider.js';
@@ -68,7 +73,9 @@ export type { YjsProvider } from '../transports/yjs-provider.js';
 export { joinHallRoom } from '../modules/hall/browser.js';
 export type { JoinHallRoomOptions } from '../modules/hall/browser.js';
 export type { HallRoomHandle, HallRoomHandleEvents, TranscriptEvent, ConceptMentionEvent, RelationProposedEvent, SpeakerChangedEvent, PeerJoinedEvent, PeerLeftEvent, RoomOptions, RecordingManifest, ConceptInput, } from '../modules/hall/types.js';
+export type { SoulcraftSDK } from '../types.js';
 export type { ClientSDKOptions } from '../types.js';
+export type { SoulcraftNamespaces } from '../namespaces.js';
 export type { SoulcraftBrainy } from '../modules/brainy/types.js';
 export type { BrainyChangeEvent } from '../modules/brainy/events.js';
 export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from '../modules/brainy/errors.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAC3F,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,YAAY,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAG1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAGlC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAOH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG9D,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAOpF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGxD;;;GAGG;AACH,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC5E;;;GAGG;AACH,OAAO,EAAE,oBAAoB,IAAI,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAGjG,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAC3F,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,0EAA0E;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAG9D,0EAA0E;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,YAAY,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAG1F,oFAAoF;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAOlC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/client/index.js

@@ -3,70 +3,85 @@
  * @description Browser/client entry point for @soulcraft/sdk. Exports everything needed
  * for kit apps running in a browser context to connect to a Soulcraft product backend.
  *
- * Includes: HTTP (JSON RPC), WebSocket (MessagePack binary RPC + change push), SSE
- * (server-push), and PostMessage (WebContainer iframe ↔ parent frame) transports.
- * Cookie-based and Bearer token auth. The Brainy proxy factory for creating a
- * fully-typed `sdk.brainy` API surface over any transport.
+ * ## SDK 2.0 — Namespace-aware transports (recommended)
  *
- * This entry point has no server-only dependencies — it is safe to bundle for the
- * browser. The trade-off is that it cannot create Brainy instances directly.
+ * Use `createSoulcraftProxy()` with a namespace-aware transport for full access to
+ * all 25 SDK namespaces (brainy, chat, graph, search, ai, media, realtime, etc.).
  *
- * @example HTTP transport (kit apps, stateless)
- * ```typescript
- * import { createBrainyProxy, HttpTransport } from '@soulcraft/sdk/client'
+ * - {@link HttpRpcTransport} — JSON POST to `/api/rpc`. Stateless, works everywhere.
+ * - {@link PostMessageRpcTransport} — `soulcraft:request` PostMessage. WebContainer iframes.
+ * - {@link WsTransport} — MessagePack binary over WebSocket. Real-time, bidirectional.
  *
- * const brainy = createBrainyProxy(
- *   new HttpTransport('https://workshop.soulcraft.com', undefined, true)
- * )
+ * ## Legacy transports (brainy-only)
  *
- * const results = await brainy.find({ query: 'candle kits', limit: 10 })
- * ```
+ * These transports only support the `brainy` namespace. They still work for backward
+ * compatibility but should be migrated to the namespace-aware transports above.
  *
- * @example WebSocket transport (real-time, change push)
- * ```typescript
- * import { createBrainyProxy, WsTransport } from '@soulcraft/sdk/client'
+ * - `LegacyHttpTransport` — `/api/brainy/rpc` only.
+ * - `LegacyPostMessageTransport` — `brainy:request` only.
+ * - `WorkshopTransport` — `workshop:request` non-brainy relay (superseded by PostMessageRpcTransport).
  *
- * const transport = new WsTransport(
- *   'wss://venue.soulcraft.com/api/brainy/ws',
- *   capabilityToken,
- *   'wicks-and-whiskers'
- * )
- * await transport.connect()
- *
- * const brainy = createBrainyProxy(transport)
- * brainy.onDataChange((event) => console.log('live change:', event))
+ * @example SDK 2.0 — full namespace access
+ * ```typescript
+ * import { createSoulcraftProxy, HttpRpcTransport } from '@soulcraft/sdk/client'
  *
- * const items = await brainy.find({ query: 'inventory' })
+ * const sdk = createSoulcraftProxy(new HttpRpcTransport('/api'))
+ * const results = await sdk.brainy.find({ query: 'candle kits' })
+ * const graph = await sdk.graph.getData()
  * ```
  *
- * @example SSE transport (receive-only change events, paired with HTTP)
+ * @example SDK 2.0 — PostMessage in WebContainer iframe
  * ```typescript
- * import { createBrainyProxy, HttpTransport, SseTransport } from '@soulcraft/sdk/client'
+ * import { createSoulcraftProxy, PostMessageRpcTransport } from '@soulcraft/sdk/client'
  *
- * const http = new HttpTransport('https://venue.soulcraft.com', undefined, true)
- * const sse = new SseTransport('https://venue.soulcraft.com', workspaceId)
- * sse.connect()
- *
- * const brainy = createBrainyProxy(http)
- * sse.onEvent((event) => refreshUI(event))
+ * const sdk = createSoulcraftProxy(new PostMessageRpcTransport(parentOrigin))
+ * const entities = await sdk.brainy.find({ query: 'notes' })
+ * for await (const chunk of sdk.chat.sendStreaming('Summarize my notes')) {
+ *   if (chunk.type === 'text') process.stdout.write(chunk.text!)
+ * }
  * ```
  */
-// ── Client SDK factory ────────────────────────────────────────────────────────
+// ═══════════════════════════════════════════════════════════════════════════════
+// SDK 2.0 — Namespace proxy + transports (recommended)
+// ═══════════════════════════════════════════════════════════════════════════════
+// ── Namespace proxy factory ─────────────────────────────────────────────────
+export { createSoulcraftProxy } from './namespace-proxy.js';
+// ── Namespace-aware transports ──────────────────────────────────────────────
+export { HttpNamespaceTransport, PostMessageNamespaceTransport, HttpRpcTransport, PostMessageRpcTransport, } from '../transports/http-namespace.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Legacy — Brainy-only transports + factories (deprecated in SDK 2.0)
+// ═══════════════════════════════════════════════════════════════════════════════
+// ── Client SDK factory (creates brainy-only SDK) ────────────────────────────
 export { createClientSDK } from './create-client-sdk.js';
-// ── Transport classes ─────────────────────────────────────────────────────────
-export { HttpTransport } from '../transports/http.js';
+// ── Brainy-only transports ──────────────────────────────────────────────────
+/**
+ * @deprecated Use {@link HttpRpcTransport} for full namespace support.
+ * This transport only supports the `brainy` namespace at `/api/brainy/rpc`.
+ */
+export { HttpTransport as LegacyHttpTransport } from '../transports/http.js';
+/**
+ * @deprecated Use {@link PostMessageRpcTransport} for full namespace support.
+ * This transport only supports `brainy:request` / `brainy:response`.
+ */
+export { PostMessageTransport as LegacyPostMessageTransport } from '../transports/postmessage.js';
+// Keep WsTransport and SseTransport — they'll be extended for namespace support.
 export { WsTransport } from '../transports/ws.js';
 export { SseTransport } from '../transports/sse.js';
-export { PostMessageTransport } from '../transports/postmessage.js';
-// ── Proxy factory ─────────────────────────────────────────────────────────────
+// ── Brainy proxy factory (brainy-only) ──────────────────────────────────────
+/** @deprecated Use `createSoulcraftProxy()` for full namespace access. */
 export { createBrainyProxy } from '../modules/brainy/proxy.js';
-// ── App context factory ──────────────────────────────────────────────────────
+// ── App context factory ─────────────────────────────────────────────────────
+/** @deprecated Use `createSoulcraftProxy()` for full namespace access. */
 export { createAppContext } from '../modules/app-context/index.js';
-// ── Workshop transport (non-brainy PostMessage relay) ────────────────────────
+// ── Workshop transport (superseded by PostMessageRpcTransport) ──────────────
+/** @deprecated Use {@link PostMessageRpcTransport} which handles all namespaces. */
 export { WorkshopTransport } from '../transports/workshop.js';
-// ── Y.js provider (collaborative editing) ─────────────────────────────────────
+// ═══════════════════════════════════════════════════════════════════════════════
+// Shared — used by both SDK 2.0 and legacy
+// ═══════════════════════════════════════════════════════════════════════════════
+// ── Y.js provider (collaborative editing) ───────────────────────────────────
 export { createYjsProvider } from '../transports/yjs-provider.js';
-// ── Hall room client (browser WebRTC) ─────────────────────────────────────────
+// ── Hall room client (browser WebRTC) ───────────────────────────────────────
 export { joinHallRoom } from '../modules/hall/browser.js';
 export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from '../modules/brainy/errors.js';
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAInE,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAE9D,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAGlE,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAO7D,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAGjE,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAoBzD,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,kFAAkF;AAClF,uDAAuD;AACvD,kFAAkF;AAElF,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D,+EAA+E;AAC/E,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AAGxC,kFAAkF;AAClF,sEAAsE;AACtE,kFAAkF;AAElF,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,+EAA+E;AAC/E;;;GAGG;AACH,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC5E;;;GAGG;AACH,OAAO,EAAE,oBAAoB,IAAI,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAEjG,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAInD,+EAA+E;AAC/E,0EAA0E;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAE9D,+EAA+E;AAC/E,0EAA0E;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAGlE,+EAA+E;AAC/E,oFAAoF;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAO7D,kFAAkF;AAClF,2CAA2C;AAC3C,kFAAkF;AAElF,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAGjE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAsBzD,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/client/namespace-proxy.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @module client/namespace-proxy
+ * @description Universal client proxy factory for namespace-aware RPC.
+ *
+ * Extends the recursive Proxy pattern from `modules/brainy/proxy.ts` to ALL
+ * 25 SDK namespaces. Accessing `sdk.chat.send('hello')` serializes as:
+ *
+ * ```
+ * transport.callNs('chat', 'send', ['hello'])
+ * ```
+ *
+ * The first property access on the returned proxy selects the namespace.
+ * Subsequent accesses build the method path within that namespace. When the
+ * proxy is invoked as a function, the call is dispatched.
+ *
+ * ## Special namespace: brainy
+ *
+ * The `brainy` namespace is special — it delegates to the existing
+ * `createBrainyProxy()` for full backward compatibility with all existing
+ * Brainy methods, sub-APIs (vfs, versions, neural, counts), and lifecycle
+ * methods (onDataChange, offDataChange, isAlive, close).
+ *
+ * ## Streaming
+ *
+ * Methods that return `AsyncIterable` (e.g. `chat.sendStreaming`) require the
+ * transport to support streaming. The proxy calls `transport.callNsStream()`
+ * when the caller signals a stream is expected (by convention — the handler
+ * decides at the server level).
+ *
+ * @example
+ * ```typescript
+ * import { createSoulcraftProxy } from '@soulcraft/sdk/client'
+ *
+ * const soulcraft = createSoulcraftProxy(transport)
+ *
+ * // Brainy — delegates to existing BrainyProxy for full compat
+ * const results = await soulcraft.brainy.find({ query: 'candles' })
+ * const files = await soulcraft.brainy.vfs.readdir('/')
+ *
+ * // Tier 2 namespaces — new RPC dispatch
+ * const graph = await soulcraft.graph.getData()
+ * const response = await soulcraft.chat.send('Hello')
+ * ```
+ */
+import type { SoulcraftSDK } from '../types.js';
+/**
+ * Transport interface for namespace-aware RPC.
+ *
+ * Extends the concept of `SDKTransport.call()` with a namespace field. Adapters
+ * for HTTP, WebSocket, and PostMessage implement this by encoding the namespace
+ * into their respective wire formats.
+ */
+export interface NamespaceTransport {
+    /**
+     * Dispatch a namespace-aware RPC call.
+     *
+     * @param ns - Target namespace (e.g. `'chat'`, `'graph'`, `'brainy.vfs'`).
+     * @param method - Method within the namespace (e.g. `'send'`, `'getData'`).
+     * @param args - Positional arguments.
+     * @returns The handler's return value.
+     */
+    callNs(ns: string, method: string, args: unknown[]): Promise<unknown>;
+    /**
+     * Dispatch a streaming namespace-aware RPC call.
+     *
+     * @param ns - Target namespace.
+     * @param method - Method within the namespace.
+     * @param args - Positional arguments.
+     * @returns An async iterable of response chunks.
+     */
+    callNsStream(ns: string, method: string, args: unknown[]): AsyncIterable<unknown>;
+    /**
+     * Returns `true` if the transport has an active connection.
+     */
+    isAlive(): boolean;
+    /**
+     * Gracefully close the transport.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Creates a `SoulcraftSDK` proxy backed by a {@link NamespaceTransport}.
+ *
+ * Every property access on the returned object is intercepted:
+ * - First-level access selects the namespace (e.g. `sdk.chat`)
+ * - Second-level access selects the method (e.g. `sdk.chat.send`)
+ * - Invoking as a function dispatches the RPC call
+ *
+ * Lifecycle methods (`connect`, `disconnect`, `shutdown`) are wired to
+ * the transport's lifecycle. The `brainy` namespace supports sub-namespaces
+ * (`brainy.vfs`, `brainy.versions`) via namespace promotion.
+ *
+ * @param transport - The namespace-aware transport.
+ * @returns A fully typed `SoulcraftSDK` proxy.
+ *
+ * @example
+ * ```typescript
+ * import { createSoulcraftProxy, HttpTransport } from '@soulcraft/sdk/client'
+ *
+ * const transport = new HttpTransport('https://workshop.soulcraft.com')
+ * const sdk = createSoulcraftProxy(transport)
+ *
+ * const graph = await sdk.graph.getData()
+ * const results = await sdk.brainy.find({ query: 'candles' })
+ * ```
+ */
+export declare function createSoulcraftProxy(transport: NamespaceTransport): SoulcraftSDK;
+//# sourceMappingURL=namespace-proxy.d.ts.map

package/dist/client/namespace-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-proxy.d.ts","sourceRoot":"","sources":["../../src/client/namespace-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO/C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAErE;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IAEjF;;OAEG;IACH,OAAO,IAAI,OAAO,CAAA;IAElB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,kBAAkB,GAAG,YAAY,CAEhF"}

package/dist/client/namespace-proxy.js

@@ -0,0 +1,151 @@
+/**
+ * @module client/namespace-proxy
+ * @description Universal client proxy factory for namespace-aware RPC.
+ *
+ * Extends the recursive Proxy pattern from `modules/brainy/proxy.ts` to ALL
+ * 25 SDK namespaces. Accessing `sdk.chat.send('hello')` serializes as:
+ *
+ * ```
+ * transport.callNs('chat', 'send', ['hello'])
+ * ```
+ *
+ * The first property access on the returned proxy selects the namespace.
+ * Subsequent accesses build the method path within that namespace. When the
+ * proxy is invoked as a function, the call is dispatched.
+ *
+ * ## Special namespace: brainy
+ *
+ * The `brainy` namespace is special — it delegates to the existing
+ * `createBrainyProxy()` for full backward compatibility with all existing
+ * Brainy methods, sub-APIs (vfs, versions, neural, counts), and lifecycle
+ * methods (onDataChange, offDataChange, isAlive, close).
+ *
+ * ## Streaming
+ *
+ * Methods that return `AsyncIterable` (e.g. `chat.sendStreaming`) require the
+ * transport to support streaming. The proxy calls `transport.callNsStream()`
+ * when the caller signals a stream is expected (by convention — the handler
+ * decides at the server level).
+ *
+ * @example
+ * ```typescript
+ * import { createSoulcraftProxy } from '@soulcraft/sdk/client'
+ *
+ * const soulcraft = createSoulcraftProxy(transport)
+ *
+ * // Brainy — delegates to existing BrainyProxy for full compat
+ * const results = await soulcraft.brainy.find({ query: 'candles' })
+ * const files = await soulcraft.brainy.vfs.readdir('/')
+ *
+ * // Tier 2 namespaces — new RPC dispatch
+ * const graph = await soulcraft.graph.getData()
+ * const response = await soulcraft.chat.send('Hello')
+ * ```
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Proxy factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates a `SoulcraftSDK` proxy backed by a {@link NamespaceTransport}.
+ *
+ * Every property access on the returned object is intercepted:
+ * - First-level access selects the namespace (e.g. `sdk.chat`)
+ * - Second-level access selects the method (e.g. `sdk.chat.send`)
+ * - Invoking as a function dispatches the RPC call
+ *
+ * Lifecycle methods (`connect`, `disconnect`, `shutdown`) are wired to
+ * the transport's lifecycle. The `brainy` namespace supports sub-namespaces
+ * (`brainy.vfs`, `brainy.versions`) via namespace promotion.
+ *
+ * @param transport - The namespace-aware transport.
+ * @returns A fully typed `SoulcraftSDK` proxy.
+ *
+ * @example
+ * ```typescript
+ * import { createSoulcraftProxy, HttpTransport } from '@soulcraft/sdk/client'
+ *
+ * const transport = new HttpTransport('https://workshop.soulcraft.com')
+ * const sdk = createSoulcraftProxy(transport)
+ *
+ * const graph = await sdk.graph.getData()
+ * const results = await sdk.brainy.find({ query: 'candles' })
+ * ```
+ */
+export function createSoulcraftProxy(transport) {
+    return _createRootProxy(transport);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal recursive proxy
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates the root-level proxy that intercepts namespace selection.
+ *
+ * @param transport - The namespace transport.
+ * @returns A Proxy that dispatches namespace RPC calls.
+ */
+function _createRootProxy(transport) {
+    return new Proxy(function () { }, {
+        get(_target, prop) {
+            if (typeof prop === 'symbol')
+                return undefined;
+            if (prop === 'then')
+                return undefined;
+            const ns = String(prop);
+            // Root-level lifecycle methods.
+            if (ns === '_transport')
+                return transport;
+            if (ns === 'isAlive')
+                return () => transport.isAlive();
+            if (ns === 'close')
+                return () => transport.close();
+            // Return a namespace proxy that accumulates the method path.
+            return _createNamespaceProxy(transport, ns, '');
+        },
+    });
+}
+/**
+ * Creates a proxy for a specific namespace, accumulating the method path.
+ *
+ * Supports nested sub-methods (e.g. `soulcraft.brainy.vfs.readdir()`):
+ * - `ns: 'brainy'`, `methodPath: ''` → access `.vfs` → `ns: 'brainy.vfs'`, `methodPath: ''`
+ * - `ns: 'brainy.vfs'`, `methodPath: ''` → access `.readdir` → `methodPath: 'readdir'`
+ * - Invoked with `['/']` → `transport.callNs('brainy.vfs', 'readdir', ['/'])`
+ *
+ * For the `brainy` namespace, the first few sub-properties become namespace
+ * extensions (`brainy.vfs`, `brainy.versions`) rather than method paths.
+ *
+ * @param transport - The namespace transport.
+ * @param ns - The resolved namespace.
+ * @param methodPath - Accumulated dot-separated method path (empty at namespace root).
+ * @returns A callable Proxy.
+ */
+function _createNamespaceProxy(transport, ns, methodPath) {
+    return new Proxy(function () { }, {
+        get(_target, prop) {
+            if (typeof prop === 'symbol')
+                return undefined;
+            if (prop === 'then')
+                return undefined;
+            const propStr = String(prop);
+            // Brainy sub-namespace promotion: brainy.vfs, brainy.versions become
+            // their own namespace rather than a method path.
+            if (ns === 'brainy' && methodPath === '' && BRAINY_SUB_NAMESPACES.has(propStr)) {
+                return _createNamespaceProxy(transport, `brainy.${propStr}`, '');
+            }
+            // Accumulate method path.
+            const nextPath = methodPath ? `${methodPath}.${propStr}` : propStr;
+            return _createNamespaceProxy(transport, ns, nextPath);
+        },
+        apply(_target, _thisArg, args) {
+            // The proxy was invoked as a function — dispatch the RPC call.
+            if (!methodPath) {
+                // Namespace-level invocation (e.g. `soulcraft.brainy()`) — not valid.
+                return Promise.reject(new Error(`Cannot call namespace '${ns}' directly. Use a method, e.g. ${ns}.someMethod()`));
+            }
+            return transport.callNs(ns, methodPath, args);
+        },
+    });
+}
+/** Brainy sub-properties that promote to their own namespace. */
+const BRAINY_SUB_NAMESPACES = new Set(['vfs', 'versions']);
+//# sourceMappingURL=namespace-proxy.js.map

package/dist/client/namespace-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-proxy.js","sourceRoot":"","sources":["../../src/client/namespace-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAgDH,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA6B;IAChE,OAAO,gBAAgB,CAAC,SAAS,CAAiB,CAAA;AACpD,CAAC;AAED,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,SAA6B;IACrD,OAAO,IAAI,KAAK,CAAC,cAAa,CAAC,EAAE;QAC/B,GAAG,CAAC,OAAO,EAAE,IAAqB;YAChC,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC9C,IAAI,IAAI,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAA;YAErC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAEvB,gCAAgC;YAChC,IAAI,EAAE,KAAK,YAAY;gBAAE,OAAO,SAAS,CAAA;YACzC,IAAI,EAAE,KAAK,SAAS;gBAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;YACtD,IAAI,EAAE,KAAK,OAAO;gBAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;YAElD,6DAA6D;YAC7D,OAAO,qBAAqB,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;QACjD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,qBAAqB,CAC5B,SAA6B,EAC7B,EAAU,EACV,UAAkB;IAElB,OAAO,IAAI,KAAK,CAAC,cAAa,CAAC,EAAE;QAC/B,GAAG,CAAC,OAAO,EAAE,IAAqB;YAChC,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC9C,IAAI,IAAI,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAA;YAErC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAE5B,qEAAqE;YACrE,iDAAiD;YACjD,IAAI,EAAE,KAAK,QAAQ,IAAI,UAAU,KAAK,EAAE,IAAI,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,OAAO,qBAAqB,CAAC,SAAS,EAAE,UAAU,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;YAClE,CAAC;YAED,0BAA0B;YAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;YAClE,OAAO,qBAAqB,CAAC,SAAS,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAA;QACvD,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAe;YACtC,+DAA+D;YAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,sEAAsE;gBACtE,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,0BAA0B,EAAE,kCAAkC,EAAE,eAAe,CAAC,CAC3F,CAAA;YACH,CAAC;YACD,OAAO,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;QAC/C,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -32,4 +32,6 @@ export type { WvizDocument, WvizEntity, WvizEdge, WvizSnapshot, WvizViewType, Wd
 export { SOULCRAFT_FORMATS } from './modules/formats/types.js';
 export type { BillingModule, BillingPlanType, SubscriptionStatus, ModelUsage, UsageData, UsageStatus, SubscriptionData, LimitCheckResult, BatchIncrementData, CreateCheckoutSessionOptions, CreatePortalSessionOptions, } from './modules/billing/types.js';
 export type { NotificationsModule, Notification, NotificationResult, NotificationSender, EmailNotification, SmsNotification, } from './modules/notifications/types.js';
+export type { SoulcraftRPC, SoulcraftRPCResponse, SoulcraftRPCStream, SoulcraftRPCError, SoulcraftPostMessageRequest, SoulcraftPostMessageResponse, SoulcraftPostMessageStream, SoulcraftPostMessageEvent, SoulcraftPostMessage, } from './rpc.js';
+export type { SoulcraftNamespaces, ChatNamespace, GraphNamespace, SearchNamespace, CollectionsNamespace, AnnotationsNamespace, WorkspaceNamespace, PublishNamespace, ImportNamespace, ExportNamespace, ConfigNamespace, SettingsNamespace, ProjectNamespace, SessionNamespace, PulseNamespace, AuthNamespace, MediaNamespace, RealtimeNamespace, CommerceNamespace, CertificationNamespace, FormatsNamespace, ChatStreamChunk, ChatConversation, ChatMessage, ChatConversationDetail, GraphData, GraphNode, GraphEdge, GraphStats, SearchResult, ViewCollection, Annotation, WorkspaceInfo, WorkspaceStatus, PublishedLink, ImportProgress, ExportFormat, PlatformConfig, ApiKeyInfo, StorageUsage, SessionState, MediaUploadResult, MediaInfo, RealtimePeer, RealtimeSubscription, CommerceProduct, CheckoutSession, PaymentRecord, Certification, AssessmentResult, OutputFormat, FormatValidationResult, } from './namespaces.js';
 //# sourceMappingURL=index.d.ts.map