@vibesdotdev/storage 0.0.2 → 1.0.0-rc.3

package/dist/adapters/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * Storage Adapters
- *
- * Concrete adapter implementations are resolved through the vibes runtime.
- * Feature packages must NEVER import adapter packages directly.
- *
- * Adapters register themselves via runtime plugins; consumers query them
- * through `runtime.query('storage/adapter')` or use the StorageManifest
- * abstraction which handles adapter resolution internally.
- *
- * External integrations (SharePoint, etc.) live in their owning integration
- * package (e.g. `@vibesdotdev/integrations-microsoft/sharepoint`).
- */
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/adapters/index.js

@@ -1,15 +0,0 @@
-"use strict";
-/**
- * Storage Adapters
- *
- * Concrete adapter implementations are resolved through the vibes runtime.
- * Feature packages must NEVER import adapter packages directly.
- *
- * Adapters register themselves via runtime plugins; consumers query them
- * through `runtime.query('storage/adapter')` or use the StorageManifest
- * abstraction which handles adapter resolution internally.
- *
- * External integrations (SharePoint, etc.) live in their owning integration
- * package (e.g. `@vibesdotdev/integrations-microsoft/sharepoint`).
- */
-//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG"}

package/dist/cli/context.consumer.d.ts

@@ -1,26 +0,0 @@
-/**
- * Storage Context Consumer
- *
- * Provides storage context for consumer hardware scope.
- * Uses runtime-injected fs/crypto/path abstraction to avoid
- * universal core importing Node.js built-ins directly.
- */
-export declare function getStorageContext(): Promise<{
-    project: {
-        json: <T>(namespace: string) => {
-            read: () => Promise<T | null>;
-            write: (value: T) => Promise<void>;
-        };
-    };
-}>;
-export declare function subscribeStorage<T>(resource: string, handler: (event: {
-    value: T | null;
-}) => void, options?: {
-    delivery?: {
-        type: 'debounce';
-        ms: number;
-    };
-}): Promise<{
-    unsubscribe: () => void;
-}>;
-//# sourceMappingURL=context.consumer.d.ts.map

package/dist/cli/context.consumer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.consumer.d.ts","sourceRoot":"","sources":["../../src/cli/context.consumer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0FH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC;IAClD,OAAO,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK;YAC/B,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC9B,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;SACnC,CAAC;KACF,CAAC;CACF,CAAC,CAsBD;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,KAAK,IAAI,EAC7C,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvD,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CA+DtC"}

package/dist/cli/context.consumer.js

@@ -1,164 +0,0 @@
-/**
- * Storage Context Consumer
- *
- * Provides storage context for consumer hardware scope.
- * Uses runtime-injected fs/crypto/path abstraction to avoid
- * universal core importing Node.js built-ins directly.
- */
-import { getConsumerFs } from '../interfaces/storage-consumer-fs.js';
-import { resolveWorkspacePath } from '../paths.js';
-const STORAGE_ROOT = '.vibes/storage';
-const PROJECT_JSON_PREFIX = 'project/json/';
-function sanitizeNamespace(namespace) {
-    return namespace.replace(/[^a-zA-Z0-9._-]/g, '-');
-}
-async function getProjectJsonDir(fs) {
-    return fs.join(await resolveWorkspaceRoot(fs), STORAGE_ROOT, 'project', 'json');
-}
-async function getProjectJsonFile(fs, namespace) {
-    return fs.join(await getProjectJsonDir(fs), `${sanitizeNamespace(namespace)}.json`);
-}
-async function resolveWorkspaceRoot(fs) {
-    const fromContextPath = await findWorkspaceRoot(fs, resolveWorkspacePath());
-    if (fromContextPath) {
-        return fromContextPath;
-    }
-    const fromCwd = await findWorkspaceRoot(fs, fs.resolve('.'));
-    if (fromCwd) {
-        return fromCwd;
-    }
-    const fromModulePath = await findWorkspaceRoot(fs, fs.resolve(import.meta.dir, '../../../../../'));
-    if (fromModulePath) {
-        return fromModulePath;
-    }
-    return resolveWorkspacePath();
-}
-async function findWorkspaceRoot(fs, startPath) {
-    let current = fs.resolve(startPath);
-    let previous = '';
-    while (current !== previous) {
-        const hasPackage = fs.existsSync(fs.join(current, 'package.json'));
-        const hasVibesBin = fs.existsSync(fs.join(current, 'src', 'bin', 'vibes.ts'));
-        if (hasPackage && hasVibesBin) {
-            return current;
-        }
-        previous = current;
-        current = fs.dirname(current);
-    }
-    return null;
-}
-async function readJson(fs, filePath) {
-    try {
-        const raw = await fs.readFile(filePath, 'utf8');
-        if (!raw.trim()) {
-            return null;
-        }
-        return JSON.parse(raw);
-    }
-    catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-            return null;
-        }
-        throw error;
-    }
-}
-async function writeJson(fs, filePath, value) {
-    const dir = fs.dirname(filePath);
-    fs.mkdirSync(dir, { recursive: true });
-    const payload = `${JSON.stringify(value, null, 2)}\n`;
-    const tmpFile = `${filePath}.tmp.${process.pid}.${Date.now()}.${fs.randomUUID()}`;
-    await fs.writeFile(tmpFile, payload, 'utf8');
-    try {
-        await fs.rename(tmpFile, filePath);
-    }
-    catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-            fs.mkdirSync(dir, { recursive: true });
-            await fs.writeFile(filePath, payload, 'utf8');
-            return;
-        }
-        throw error;
-    }
-}
-export async function getStorageContext() {
-    const fs = await getConsumerFs();
-    const dir = await getProjectJsonDir(fs);
-    fs.mkdirSync(dir, { recursive: true });
-    return {
-        project: {
-            json: (namespace) => {
-                const filePathPromise = getProjectJsonFile(fs, namespace);
-                return {
-                    read: async () => {
-                        const filePath = await filePathPromise;
-                        return readJson(fs, filePath);
-                    },
-                    write: async (value) => {
-                        const filePath = await filePathPromise;
-                        return writeJson(fs, filePath, value);
-                    }
-                };
-            }
-        }
-    };
-}
-export async function subscribeStorage(resource, handler, options) {
-    if (!resource.startsWith(PROJECT_JSON_PREFIX)) {
-        return { unsubscribe: () => undefined };
-    }
-    const fs = await getConsumerFs();
-    const namespace = resource.slice(PROJECT_JSON_PREFIX.length);
-    const filePath = await getProjectJsonFile(fs, namespace);
-    const dir = fs.dirname(filePath);
-    const targetFile = fs.basename(filePath);
-    const debounceMs = options?.delivery?.type === 'debounce' ? options.delivery.ms : 0;
-    fs.mkdirSync(dir, { recursive: true });
-    let timer = null;
-    let watcher = null;
-    const emitChange = async () => {
-        try {
-            const value = await readJson(fs, filePath);
-            handler({ value });
-        }
-        catch {
-            // ignore read errors
-        }
-    };
-    const scheduleEmit = () => {
-        if (debounceMs <= 0) {
-            void emitChange();
-            return;
-        }
-        if (timer) {
-            clearTimeout(timer);
-        }
-        timer = setTimeout(() => {
-            timer = null;
-            void emitChange();
-        }, debounceMs);
-    };
-    try {
-        watcher = fs.watch(dir, (eventType, filename) => {
-            const name = filename?.toString ? filename.toString() : filename;
-            if (!name || name !== targetFile) {
-                return;
-            }
-            if (eventType === 'change' || eventType === 'rename') {
-                scheduleEmit();
-            }
-        });
-    }
-    catch {
-        watcher = null;
-    }
-    return {
-        unsubscribe: () => {
-            if (timer) {
-                clearTimeout(timer);
-                timer = null;
-            }
-            watcher?.close();
-        }
-    };
-}
-//# sourceMappingURL=context.consumer.js.map

package/dist/cli/context.consumer.js.map

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

package/dist/docs/adapters.docs.descriptor.d.ts

@@ -1,4 +0,0 @@
-import type { DocsTopicDescriptor } from '@vibesdotdev/docs';
-declare const descriptor: DocsTopicDescriptor;
-export default descriptor;
-//# sourceMappingURL=adapters.docs.descriptor.d.ts.map

package/dist/docs/adapters.docs.descriptor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapters.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/adapters.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,QAAA,MAAM,UAAU,EAAE,mBA4NjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/adapters.docs.descriptor.js

@@ -1,223 +0,0 @@
-const descriptor = {
-    kind: 'docs/topic',
-    id: 'storage.adapters',
-    title: 'Storage Adapters',
-    summary: 'Storage adapter interface, adapter implementations (libsql/D1/memory), and registration',
-    body: {
-        type: 'markdown',
-        sourceType: 'raw',
-        source: `---
-title: Storage Adapters
-summary: Storage adapter interface, adapter implementations (libsql/D1/memory), and registration
-tags: [storage, adapters, interface, registration]
-parent: storage
-order: 1
-surfaces: [cli, web, in-app]
-hardware: [consumer, cloud]
----
-
-# Storage Adapters
-
-Storage adapters provide the persistence layer for the vibes storage system. The \`storage/adapter\` runtime kind defines the interface that all adapters must implement.
-
-## Adapter Interface
-
-All adapters implement the \`StorageAdapterInterface\`:
-
-\`\`\`ts
-interface StorageAdapterInterface {
-  // Document operations
-  documentStore<T>(namespace: string, schema: ZodSchema<T>): {
-    load(): Promise<T | null>;
-    save(data: T): Promise<void>;
-    exists(): Promise<boolean>;
-    delete(): Promise<void>;
-  };
-
-  // Repository operations
-  repository<T>(namespace: string, schema: ZodSchema<T>): {
-    find(id: string): Promise<T | null>;
-    findAll(query?: Query): Promise<T[]>;
-    insert(data: T): Promise<T>;
-    update(id: string, data: Partial<T>): Promise<T>;
-    delete(id: string): Promise<void>;
-  };
-
-  // Lifecycle
-  ensureReady(): Promise<void>;
-  close(): Promise<void>;
-}
-\`\`\`
-
-## Available Adapters
-
-### Memory Adapter
-
-In-memory storage for testing and ephemeral use:
-
-\`\`\`ts
-import { storageAdapterMemoryPlugin } from '@vibesdotdev/storage-adapter-memory';
-await runtime.registerPlugin(storageAdapterMemoryPlugin);
-\`\`\`
-
-**Use cases:**
-- Unit and integration tests
-- Development prototyping
-- Caching layers
-
-**Limitations:**
-- Data lost on process restart
-- No concurrent access support
-
-### LibSQL Adapter
-
-Local SQLite storage using libsql:
-
-\`\`\`ts
-import { storageAdapterLibsqlPlugin } from '@vibesdotdev/storage-adapter-libsql';
-await runtime.registerPlugin(storageAdapterLibsqlPlugin({
-  dbUrl: 'file:local.db'
-}));
-\`\`\`
-
-**Use cases:**
-- Single-user desktop apps
-- Local-first applications
-- Edge computing scenarios
-
-### D1 Adapter
-
-Cloudflare D1 database adapter:
-
-\`\`\`ts
-import { storageAdapterD1Plugin } from '@vibesdotdev/storage-adapter-d1';
-await runtime.registerPlugin(storageAdapterD1Plugin({
-  binding: env.DB  // Cloudflare D1 binding
-}));
-\`\`\`
-
-**Use cases:**
-- Cloudflare Workers deployments
-- Serverless applications
-- Multi-tenant SaaS
-
-### Drizzle ORM Adapter
-
-Database-agnostic adapter via Drizzle ORM:
-
-\`\`\`ts
-import { storageAdapterDrizzlePlugin } from '@vibesdotdev/storage-adapter-drizzle';
-import { drizzle } from 'drizzle-orm/postgres-js';
-import postgres from 'postgres';
-
-const client = postgres(process.env.DATABASE_URL!);
-const db = drizzle(client);
-
-await runtime.registerPlugin(storageAdapterDrizzlePlugin({ db }));
-\`\`\`
-
-**Use cases:**
-- Production PostgreSQL deployments
-- Complex queries and relations
-- Migration management
-
-### Cloud-API Adapter
-
-Remote storage via HTTP API (used for sync):
-
-\`\`\`ts
-import { storageAdapterCloudApiPlugin } from '@vibesdotdev/storage-adapter-cloud-api';
-await runtime.registerPlugin(storageAdapterCloudApiPlugin({
-  baseUrl: 'https://storage.vibes.dev',
-  authToken: '...'
-}));
-\`\`\`
-
-**Use cases:**
-- Cross-app sync (see \`storage.sync\`)
-- Centralized backup
-- Multi-device synchronization
-
-## Adapter Registration
-
-Adapters register themselves via runtime plugins:
-
-\`\`\`ts
-import { getVibesRuntime } from '@vibesdotdev/runtime';
-import { storagePlugin } from '@vibesdotdev/storage';
-import { storageAdapterMemoryPlugin } from '@vibesdotdev/storage-adapter-memory';
-
-const runtime = getVibesRuntime();
-
-// Register core storage first
-await runtime.registerPlugin(storagePlugin);
-
-// Then register adapter
-await runtime.registerPlugin(storageAdapterMemoryPlugin);
-\`\`\`
-
-## Adapter Resolution
-
-The runtime resolves adapters based on hardware scope:
-
-\`\`\`ts
-// Runtime auto-selects based on scope
-const adapter = await runtime.query('storage/adapter')
-  .forHardware('consumer')
-  .resolve();
-
-// Or filter explicitly
-const adapter = await runtime.query('storage/adapter')
-  .filter(d => d.id === 'storage.adapter.libsql')
-  .resolve();
-\`\`\`
-
-**Resolution priority:**
-1. Explicit filter match
-2. Hardware compatibility
-3. Persistent over memory adapters
-4. First registered
-
-## Writing Custom Adapters
-
-Create a plugin that registers a \`storage/adapter\` descriptor:
-
-\`\`\`ts
-import { createRuntimePlugin } from '@vibesdotdev/runtime';
-import type { StorageAdapterDescriptor } from '@vibesdotdev/storage';
-
-const descriptor: StorageAdapterDescriptor = {
-  kind: 'storage/adapter',
-  id: 'storage.adapter.custom',
-  title: 'Custom Adapter',
-  persistent: true,
-  hardware: ['consumer', 'cloud']
-};
-
-export const customAdapterPlugin = createRuntimePlugin({
-  id: 'custom-adapter',
-  kinds: [{
-    id: 'storage/adapter',
-    descriptorSchema: StorageAdapterDescriptorSchema,
-    defaultImplementation: CustomAdapterImpl
-  }],
-  descriptors: [descriptor]
-});
-\`\`\`
-
-:::card{title="See also"}
-- [\`storage.manifests\`](storage.manifests) — Manifest declarations
-- [\`storage.records\`](storage.records) — Record CRUD operations
-- [\`storage.sync\`](storage.sync) — Cross-app synchronization
-:::
-`
-    },
-    parent: 'storage',
-    order: 1,
-    tags: ['storage', 'adapters', 'interface', 'registration'],
-    surfaces: ['cli', 'web', 'in-app'],
-    hardware: ['consumer', 'cloud'],
-    enabled: true
-};
-export default descriptor;
-//# sourceMappingURL=adapters.docs.descriptor.js.map

package/dist/docs/adapters.docs.descriptor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapters.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/adapters.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,yFAAyF;IAClG,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4MT;KACC;IACD,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,CAAC;IAC1D,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/manifests.docs.descriptor.d.ts

@@ -1,4 +0,0 @@
-import type { DocsTopicDescriptor } from '@vibesdotdev/docs';
-declare const descriptor: DocsTopicDescriptor;
-export default descriptor;
-//# sourceMappingURL=manifests.docs.descriptor.d.ts.map

package/dist/docs/manifests.docs.descriptor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"manifests.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/manifests.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,QAAA,MAAM,UAAU,EAAE,mBAyTjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/manifests.docs.descriptor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"manifests.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/manifests.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,mBAAmB;IAC1B,OAAO,EAAE,qEAAqE;IAC9E,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyST;KACC;IACD,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,CAAC;IACxE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/src/adapters/index.ts

@@ -1,13 +0,0 @@
-/**
- * Storage Adapters
- *
- * Concrete adapter implementations are resolved through the vibes runtime.
- * Feature packages must NEVER import adapter packages directly.
- *
- * Adapters register themselves via runtime plugins; consumers query them
- * through `runtime.query('storage/adapter')` or use the StorageManifest
- * abstraction which handles adapter resolution internally.
- *
- * External integrations (SharePoint, etc.) live in their owning integration
- * package (e.g. `@vibesdotdev/integrations-microsoft/sharepoint`).
- */

package/src/bridge/index.ts

@@ -1,2 +0,0 @@
-export { bridgeStorageKinds } from './storage-kind-bridge';
-export type { StorageKindBridgeConfig } from './types';

package/src/bridge/storage-kind-bridge.ts

@@ -1,131 +0,0 @@
-/**
- * Storage Kind Bridge
- *
- * Hydrates runtime kind registries from storage manifest data.
- * Storage manifests that declare `providesRuntimeKinds` will have their
- * stored items loaded and registered as runtime descriptors (and optionally
- * implementation loaders) so they are discoverable via `runtime.query()`.
- *
- * This runs at boot after discovery completes and storage adapters are available.
- */
-
-import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
-import type { StorageManifestDescriptor } from '../schemas/manifest-descriptor';
-import { StorageManifest } from '../manifest/base';
-import type { StorageKindBridgeConfig } from './types';
-import { createTracer } from '@vibesdotdev/runtime/debug';
-
-/**
- * Bridge storage manifest items into runtime kind registries.
- *
- * For each storage manifest with `providesRuntimeKinds`:
- * 1. Loads stored data via the manifest's resolved adapter
- * 2. Transforms each item into a runtime descriptor
- * 3. Registers the descriptor (makes it queryable)
- * 4. Optionally registers an implementation loader
- *
- * @returns Count of bridged items and any errors encountered
- */
-export async function bridgeStorageKinds(
-	runtime: VibesRuntime
-): Promise<{ bridged: number; errors: string[] }> {
-	const bridgeTracer = createTracer('bridgeStorageKinds');
-	bridgeTracer.start();
-
-	if (!runtime.hasKind('storage/manifest')) {
-		bridgeTracer.end('no storage/manifest kind');
-		return { bridged: 0, errors: [] };
-	}
-
-	const manifests = runtime.assets('storage/manifest').descriptors();
-	let bridged = 0;
-	const errors: string[] = [];
-
-	// Process manifests in parallel to reduce I/O wait time
-	const manifestPromises = (manifests as StorageManifestDescriptor[]).map(async (manifest) => {
-		const storageManifest = manifest;
-		const bridgeConfig = storageManifest.providesRuntimeKinds;
-		if (!bridgeConfig) return { bridged: 0, errors: [] as string[] };
-
-		const manifestTracer = createTracer(`manifest:${manifest.id}`);
-		manifestTracer.start();
-
-		let items: unknown[];
-		try {
-			const storage = StorageManifest.fromId(manifest.id);
-			const data = await storage.load();
-			if (!data) {
-				manifestTracer.end('no data');
-				return { bridged: 0, errors: [] as string[] };
-			}
-			if (Array.isArray(data)) {
-				items = data;
-			} else if (typeof data === 'object' && data !== null) {
-				// Record/object storage: extract values as individual items
-				items = Object.values(data);
-			} else {
-				items = [data];
-			}
-			manifestTracer.end(`loaded ${items.length} items`);
-		} catch (err) {
-			manifestTracer.end('failed');
-			return {
-				bridged: 0,
-				errors: [
-					`Failed to load storage '${manifest.id}': ${err instanceof Error ? err.message : String(err)}`
-				]
-			};
-		}
-
-		let manifestBridged = 0;
-		const manifestErrors: string[] = [];
-
-		for (const [kindId, rawConfig] of Object.entries(bridgeConfig)) {
-			if (!runtime.hasKind(kindId)) {
-				manifestErrors.push(
-					`Storage '${manifest.id}' declares providesRuntimeKinds for unregistered kind '${kindId}'`
-				);
-				continue;
-			}
-
-			const config = rawConfig as StorageKindBridgeConfig;
-
-			for (const item of items) {
-				try {
-					if (config.filter && !config.filter(item)) continue;
-
-					const descriptor = config.toDescriptor(item);
-
-					runtime.registerDescriptor(kindId, descriptor);
-
-					if (config.implementation) {
-						const ImplClass = config.implementation;
-						runtime.registerLoader(kindId, descriptor.id, async () => ({
-							meta: { id: descriptor.id, kind: kindId, priority: 0 },
-							impl: ImplClass
-						}));
-					}
-
-					manifestBridged++;
-				} catch (err) {
-					manifestErrors.push(
-						`Failed to bridge item from '${manifest.id}' to '${kindId}': ${err instanceof Error ? err.message : String(err)}`
-					);
-				}
-			}
-		}
-
-		return { bridged: manifestBridged, errors: manifestErrors };
-	});
-
-	// Wait for all manifest processing to complete
-	const results = await Promise.all(manifestPromises);
-
-	for (const result of results) {
-		bridged += result.bridged;
-		errors.push(...result.errors);
-	}
-
-	bridgeTracer.end(`bridged ${bridged} items`);
-	return { bridged, errors };
-}