@vibesdotdev/storage 0.0.1

package/dist/tui/storage-explorer.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-explorer.impl.consumer.js","sourceRoot":"","sources":["../../src/tui/storage-explorer.impl.consumer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,cAAc,GAA4B;IAC/C,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;CACzF,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/tui/storage-open.descriptor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Storage Open — tui/command descriptor
+ *
+ * Navigates to the Storage Explorer.
+ * Triggered via /storage slash command or keybinding.
+ *
+ * NOTE: The actual TUI types (TuiCommandDescriptor) live in @vibesdotdev/tui, but
+ * storage must not depend on tui in production (that would re-create the cycle).
+ * We declare the shape inline here using the base RuntimeDescriptor-compatible fields.
+ */
+import type { RuntimeDescriptor } from '@vibesdotdev/runtime';
+declare const descriptor: RuntimeDescriptor & Record<string, unknown>;
+export default descriptor;
+//# sourceMappingURL=storage-open.descriptor.d.ts.map

package/dist/tui/storage-open.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-open.descriptor.d.ts","sourceRoot":"","sources":["../../src/tui/storage-open.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,QAAA,MAAM,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAeZ,CAAC;AAEjD,eAAe,UAAU,CAAC"}

package/dist/tui/storage-open.descriptor.js

@@ -0,0 +1,28 @@
+/**
+ * Storage Open — tui/command descriptor
+ *
+ * Navigates to the Storage Explorer.
+ * Triggered via /storage slash command or keybinding.
+ *
+ * NOTE: The actual TUI types (TuiCommandDescriptor) live in @vibesdotdev/tui, but
+ * storage must not depend on tui in production (that would re-create the cycle).
+ * We declare the shape inline here using the base RuntimeDescriptor-compatible fields.
+ */
+const descriptor = {
+    kind: 'tui/command',
+    id: 'storage.open',
+    title: 'Open Storage Explorer',
+    name: 'Open Storage Explorer',
+    description: 'Navigate to the Storage Explorer',
+    tags: ['navigation'],
+    // TUI-specific fields passed through as opaque data
+    trigger: '/storage',
+    aliases: ['/store', '/db'],
+    category: 'Navigation',
+    keybinding: 'g then d',
+    acceptsArgs: false,
+    order: 5,
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=storage-open.descriptor.js.map

package/dist/tui/storage-open.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-open.descriptor.js","sourceRoot":"","sources":["../../src/tui/storage-open.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,UAAU,GAAgD;IAC/D,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,uBAAuB;IAC9B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,kCAAkC;IAC/C,IAAI,EAAE,CAAC,YAAY,CAAC;IACpB,oDAAoD;IACpD,OAAO,EAAE,UAAU;IACnB,OAAO,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;IAC1B,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE,UAAU;IACtB,WAAW,EAAE,KAAK;IAClB,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,IAAI;CACkC,CAAC;AAEjD,eAAe,UAAU,CAAC"}

package/dist/tui/storage-open.impl.consumer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Storage Open TUI command implementation (consumer stub).
+ *
+ * The actual implementation requires @vibesdotdev/tui components.
+ * This stub is loaded at runtime only when the TUI stack is present.
+ * When TUI is not available, the onRegister hook in storage.plugin.ts
+ * skips registration entirely via runtime.hasKind('tui/command').
+ */
+declare const implementation: Record<string, unknown>;
+export default implementation;
+//# sourceMappingURL=storage-open.impl.consumer.d.ts.map

package/dist/tui/storage-open.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-open.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/tui/storage-open.impl.consumer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAE3C,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/tui/storage-open.impl.consumer.js

@@ -0,0 +1,13 @@
+/**
+ * Storage Open TUI command implementation (consumer stub).
+ *
+ * The actual implementation requires @vibesdotdev/tui components.
+ * This stub is loaded at runtime only when the TUI stack is present.
+ * When TUI is not available, the onRegister hook in storage.plugin.ts
+ * skips registration entirely via runtime.hasKind('tui/command').
+ */
+const implementation = {
+    execute: () => ({ type: 'navigate', route: '/storage' })
+};
+export default implementation;
+//# sourceMappingURL=storage-open.impl.consumer.js.map

package/dist/tui/storage-open.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-open.impl.consumer.js","sourceRoot":"","sources":["../../src/tui/storage-open.impl.consumer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,cAAc,GAA4B;IAC/C,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;CACxD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/utils/error-context.d.ts

@@ -0,0 +1,2 @@
+export declare function toErrorContext(error: unknown): Record<string, unknown> | undefined;
+//# sourceMappingURL=error-context.d.ts.map

package/dist/utils/error-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-context.d.ts","sourceRoot":"","sources":["../../src/utils/error-context.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAkBlF"}

package/dist/utils/error-context.js

@@ -0,0 +1,17 @@
+export function toErrorContext(error) {
+    if (error instanceof Error) {
+        return {
+            error: error.message,
+            name: error.name,
+            stack: error.stack
+        };
+    }
+    if (typeof error === 'object' && error !== null && !Array.isArray(error)) {
+        return error;
+    }
+    if (error === undefined) {
+        return undefined;
+    }
+    return { error: String(error) };
+}
+//# sourceMappingURL=error-context.js.map

package/dist/utils/error-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-context.js","sourceRoot":"","sources":["../../src/utils/error-context.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO;YACN,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;SAClB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,KAAgC,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,241 @@
+{
+  "name": "@vibesdotdev/storage",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest/index.d.ts",
+      "bun": "./src/manifest/index.ts",
+      "import": "./dist/manifest/index.js",
+      "default": "./dist/manifest/index.js"
+    },
+    "./manifest/*": {
+      "types": "./dist/manifest/*.d.ts",
+      "bun": "./src/manifest/*.ts",
+      "import": "./dist/manifest/*.js",
+      "default": "./dist/manifest/*.js"
+    },
+    "./interfaces": {
+      "types": "./dist/interfaces/index.d.ts",
+      "bun": "./src/interfaces/index.ts",
+      "import": "./dist/interfaces/index.js",
+      "default": "./dist/interfaces/index.js"
+    },
+    "./interfaces/record": {
+      "types": "./dist/interfaces/record/index.d.ts",
+      "bun": "./src/interfaces/record/index.ts",
+      "import": "./dist/interfaces/record/index.js",
+      "default": "./dist/interfaces/record/index.js"
+    },
+    "./interfaces/schema": {
+      "types": "./dist/interfaces/schema/index.d.ts",
+      "bun": "./src/interfaces/schema/index.ts",
+      "import": "./dist/interfaces/schema/index.js",
+      "default": "./dist/interfaces/schema/index.js"
+    },
+    "./interfaces/*": {
+      "types": "./dist/interfaces/*.d.ts",
+      "bun": "./src/interfaces/*.ts",
+      "import": "./dist/interfaces/*.js",
+      "default": "./dist/interfaces/*.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "bun": "./src/schemas/index.ts",
+      "import": "./dist/schemas/index.js",
+      "default": "./dist/schemas/index.js"
+    },
+    "./schemas/record": {
+      "types": "./dist/schemas/record/index.d.ts",
+      "bun": "./src/schemas/record/index.ts",
+      "import": "./dist/schemas/record/index.js",
+      "default": "./dist/schemas/record/index.js"
+    },
+    "./schemas/schema": {
+      "types": "./dist/schemas/schema/index.d.ts",
+      "bun": "./src/schemas/schema/index.ts",
+      "import": "./dist/schemas/schema/index.js",
+      "default": "./dist/schemas/schema/index.js"
+    },
+    "./schemas/*": {
+      "types": "./dist/schemas/*.d.ts",
+      "bun": "./src/schemas/*.ts",
+      "import": "./dist/schemas/*.js",
+      "default": "./dist/schemas/*.js"
+    },
+    "./sync": {
+      "types": "./dist/sync/sync-bridge.d.ts",
+      "bun": "./src/sync/sync-bridge.ts",
+      "import": "./dist/sync/sync-bridge.js",
+      "default": "./dist/sync/sync-bridge.js"
+    },
+    "./sync/*": {
+      "types": "./dist/sync/*.d.ts",
+      "bun": "./src/sync/*.ts",
+      "import": "./dist/sync/*.js",
+      "default": "./dist/sync/*.js"
+    },
+    "./record": {
+      "types": "./dist/record/index.d.ts",
+      "bun": "./src/record/index.ts",
+      "import": "./dist/record/index.js",
+      "default": "./dist/record/index.js"
+    },
+    "./record/base": {
+      "types": "./dist/record/base.d.ts",
+      "bun": "./src/record/base.ts",
+      "import": "./dist/record/base.js",
+      "default": "./dist/record/base.js"
+    },
+    "./record/*": {
+      "types": "./dist/record/*.d.ts",
+      "bun": "./src/record/*.ts",
+      "import": "./dist/record/*.js",
+      "default": "./dist/record/*.js"
+    },
+    "./bridge": {
+      "types": "./dist/bridge/index.d.ts",
+      "bun": "./src/bridge/index.ts",
+      "import": "./dist/bridge/index.js",
+      "default": "./dist/bridge/index.js"
+    },
+    "./bridge/types": {
+      "types": "./dist/bridge/types.d.ts",
+      "bun": "./src/bridge/types.ts",
+      "import": "./dist/bridge/types.js",
+      "default": "./dist/bridge/types.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "bun": "./src/client/index.ts",
+      "import": "./dist/client/index.js",
+      "default": "./dist/client/index.js"
+    },
+    "./client/*": {
+      "types": "./dist/client/*.d.ts",
+      "bun": "./src/client/*.ts",
+      "import": "./dist/client/*.js",
+      "default": "./dist/client/*.js"
+    },
+    "./resolver/*": {
+      "types": "./dist/resolver/*.d.ts",
+      "bun": "./src/resolver/*.ts",
+      "import": "./dist/resolver/*.js",
+      "default": "./dist/resolver/*.js"
+    },
+    "./cli/*": {
+      "types": "./dist/cli/*.d.ts",
+      "bun": "./src/cli/*.ts",
+      "import": "./dist/cli/*.js",
+      "default": "./dist/cli/*.js"
+    },
+    "./tui/*": {
+      "types": "./dist/tui/*.d.ts",
+      "bun": "./src/tui/*.ts",
+      "import": "./dist/tui/*.js",
+      "default": "./dist/tui/*.js"
+    },
+    "./daemon/commands/*": {
+      "types": "./dist/daemon/commands/*.d.ts",
+      "bun": "./src/daemon/commands/*.ts",
+      "import": "./dist/daemon/commands/*.js",
+      "default": "./dist/daemon/commands/*.js"
+    },
+    "./paths": {
+      "types": "./dist/paths.d.ts",
+      "bun": "./src/paths.ts",
+      "import": "./dist/paths.js",
+      "default": "./dist/paths.js"
+    },
+    "./plugin": {
+      "types": "./dist/storage.plugin.d.ts",
+      "bun": "./src/storage.plugin.ts",
+      "import": "./dist/storage.plugin.js",
+      "default": "./dist/storage.plugin.js"
+    },
+    "./storage.plugin": {
+      "types": "./dist/storage.plugin.d.ts",
+      "bun": "./src/storage.plugin.ts",
+      "import": "./dist/storage.plugin.js",
+      "default": "./dist/storage.plugin.js"
+    },
+    "./server/manifest-route": {
+      "types": "./dist/server/manifest-route.d.ts",
+      "bun": "./src/server/manifest-route.ts",
+      "import": "./dist/server/manifest-route.js",
+      "default": "./dist/server/manifest-route.js"
+    },
+    "./transform": {
+      "types": "./dist/transform/index.d.ts",
+      "bun": "./src/transform/index.ts",
+      "import": "./dist/transform/index.js",
+      "default": "./dist/transform/index.js"
+    },
+    "./transform/*": {
+      "types": "./dist/transform/*.d.ts",
+      "bun": "./src/transform/*.ts",
+      "import": "./dist/transform/*.js",
+      "default": "./dist/transform/*.js"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vibesdotdev/monorepo.git",
+    "directory": "packages/storage"
+  },
+  "peerDependencies": {
+    "@vibesdotdev/runtime": "0.0.1"
+  },
+  "dependencies": {
+    "@vibesdotdev/logging": "0.0.1",
+    "@vibesdotdev/runtime-plugin-types": "0.0.1",
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "test:isolated": "bun test src/__tests_isolated__",
+    "test:main": "bun test src/__tests__ src/manifest src/policy src/record src/resolver src/schemas src/sync src/tui",
+    "test": "bun run test:isolated && bun run test:main",
+    "check": "bun --bun tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "src",
+    "bin",
+    "README.md",
+    "SPEC.md",
+    "LICENSE",
+    "!src/**/__tests__/**",
+    "!src/**/__stubs__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.spec.ts",
+    "!src/**/*.spec.tsx",
+    "!dist/**/__tests__/**",
+    "!dist/**/__stubs__/**",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/**/*.spec.js",
+    "!dist/**/*.spec.js.map",
+    "!dist/**/*.spec.d.ts",
+    "!dist/**/*.spec.d.ts.map"
+  ],
+  "vibes": {
+    "visibility": "public-framework"
+  }
+}

package/src/adapters/index.ts

@@ -0,0 +1,13 @@
+/**
+ * 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

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

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

@@ -0,0 +1,131 @@
+/**
+ * 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 };
+}

package/src/bridge/types.ts

@@ -0,0 +1,46 @@
+/**
+ * Storage Kind Bridge Types
+ *
+ * Type-safe configuration for bridging storage manifest items
+ * into runtime kind queries.
+ */
+
+import type { RuntimeDescriptor } from '@vibesdotdev/runtime/schemas/descriptor';
+
+/**
+ * Configuration for bridging stored items to a runtime kind.
+ *
+ * Declared on a StorageManifestDescriptor via `providesRuntimeKinds`.
+ * The bridge utility reads this config to register descriptors and
+ * optional implementation loaders with the runtime.
+ *
+ * @template TStored - The shape of individual stored items
+ *
+ * @example
+ * ```ts
+ * const config: StorageKindBridgeConfig<AgentConfig> = {
+ *   toDescriptor: (item) => createAIAgentDescriptor({ ... }),
+ *   implementation: ReactAgent,
+ *   filter: (item) => item.enabled !== false
+ * };
+ * ```
+ */
+export interface StorageKindBridgeConfig<TStored = unknown> {
+	/** Transform a stored item into a runtime descriptor for this kind */
+	toDescriptor: (item: TStored) => RuntimeDescriptor;
+
+	/**
+	 * Implementation class to register as a loader.
+	 * If provided, the runtime will instantiate it with (descriptor, context)
+	 * when the asset is resolved. If omitted, the kind's defaultImplementation
+	 * is used instead.
+	 */
+	implementation?: new (descriptor: RuntimeDescriptor, context: { runtime: unknown }) => unknown;
+
+	/**
+	 * Filter which stored items to bridge.
+	 * Return true to include the item, false to skip.
+	 * If omitted, all items are bridged.
+	 */
+	filter?: (item: TStored) => boolean;
+}

package/src/cli/commands/list/storage.list.cli-command.descriptor.ts

@@ -0,0 +1,20 @@
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/runtime/schemas/asset';
+
+const descriptor: CLICommandAssetDescriptor = {
+	kind: 'cli/command',
+	id: 'storage.list',
+	name: 'list',
+	description: 'List all registered storage manifests',
+	group: 'storage',
+	arguments: [],
+	options: [
+		{ flags: '--json', description: 'Output as JSON' },
+		{ flags: '--sync-only', description: 'Only show manifests with cloud sync enabled' }
+	],
+	aliases: ['ls'],
+	surfaces: ['cli'],
+	hardware: ['consumer'],
+	enabled: true
+};
+
+export default descriptor;

package/src/cli/commands/list/storage.list.cli-command.impl.ts

@@ -0,0 +1,72 @@
+/**
+ * vibes storage list
+ *
+ * Lists all registered storage manifests with their adapter configuration,
+ * custom table status, and sync eligibility.
+ */
+
+import { getVibesRuntime } from '@vibesdotdev/runtime';
+import type { StorageCliUIContext as UIContext } from '../../types';
+
+interface ManifestDescriptor {
+	id: string;
+	namespace: string;
+	name?: string;
+	defaultAdapter?: string;
+	allowedAdapters?: string[];
+	customTables?: boolean;
+	scope?: string;
+	enabled?: boolean;
+}
+
+export default {
+	async execute(_args: Record<string, unknown>, opts: Record<string, unknown>): Promise<void> {
+		const runtime = getVibesRuntime();
+		const ui = (await runtime.context('cli/ui')) as UIContext;
+
+		try {
+			const descriptors = runtime.query('storage/manifest').descriptors() as unknown as ManifestDescriptor[];
+
+			let manifests = descriptors.filter((d) => d.enabled !== false);
+
+			if (opts.syncOnly) {
+				manifests = manifests.filter((d) => d.allowedAdapters?.includes('storage.cloud-api'));
+			}
+
+			if (opts.json) {
+				ui.render(
+					manifests.map((d) => ({
+						id: d.id,
+						namespace: d.namespace,
+						defaultAdapter: d.defaultAdapter,
+						customTables: d.customTables ?? false,
+						syncEnabled: d.allowedAdapters?.includes('storage.cloud-api') ?? false,
+						scope: d.scope ?? 'global'
+					})),
+					{ format: 'json' }
+				);
+				return;
+			}
+
+			if (manifests.length === 0) {
+				ui.info('No storage manifests registered.');
+				return;
+			}
+
+			ui.table(
+				manifests.map((d) => ({
+					ID: d.id,
+					Namespace: d.namespace,
+					Adapter: d.defaultAdapter ?? '—',
+					'Custom Tables': d.customTables ? 'yes' : 'no',
+					'Cloud Sync': d.allowedAdapters?.includes('storage.cloud-api') ? 'yes' : 'no',
+					Scope: d.scope ?? 'global'
+				})),
+				['ID', 'Namespace', 'Adapter', 'Custom Tables', 'Cloud Sync', 'Scope']
+			);
+		} catch (e) {
+			ui.error(`Failed to list manifests: ${e}`);
+			process.exit(1);
+		}
+	}
+};