@vibesdotdev/storage 0.0.1 → 1.0.0-rc.3

package/dist/svelte/tool-widgets/StorageCopyToolCard.svelte

@@ -0,0 +1,87 @@
+<script lang="ts">
+	/**
+	 * Designed widget for `storage.copy`. Reads input while the copy is in
+	 * flight and output once it finishes so common copy actions stay designed.
+	 */
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import { storageCopyWidgetView } from '../../tools/widget-views.js';
+	import { baseName, fmtSize } from './format.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const view = $derived(storageCopyWidgetView(tool.output, tool.input));
+	const sourcePath = $derived(view.sourcePath);
+	const targetPath = $derived(view.targetPath);
+	const sourceProviderId = $derived(view.sourceProviderId);
+	const targetProviderId = $derived(view.targetProviderId);
+	const sizeBytes = $derived(view.sizeBytes ?? null);
+	const contentType = $derived(view.contentType);
+	const message = $derived(view.message);
+	const copied = $derived(view.copied);
+	const fileName = $derived(baseName(sourcePath || targetPath));
+
+	const summaryTitle = $derived(
+		fileName ? `${copied ? 'Copied' : 'Copying'} ${fileName}` : copied ? 'Copied file' : 'Copy file'
+	);
+</script>
+
+<ToolCard {tool} {compact} title={summaryTitle} icon="lucide:copy">
+	<ToolCardBody {compact} aria-label="Storage copy result">
+		{#if sourcePath || targetPath}
+			<dl class="space-y-1.5">
+				{#if sourcePath}
+					<div class="flex items-center gap-2">
+						<dt class="flex shrink-0 items-center gap-1.5 text-muted-foreground">
+							<Icon icon="lucide:file" class="size-3.5" aria-hidden="true" />
+							<span>From</span>
+						</dt>
+						<dd class="min-w-0 flex-1 truncate font-mono text-foreground" title={sourcePath}>
+							{sourcePath}
+						</dd>
+					</div>
+				{/if}
+				{#if targetPath}
+					<div class="flex items-center gap-2">
+						<dt class="flex shrink-0 items-center gap-1.5 text-muted-foreground">
+							<Icon icon="lucide:corner-down-right" class="size-3.5" aria-hidden="true" />
+							<span>To</span>
+						</dt>
+						<dd class="min-w-0 flex-1 truncate font-mono text-foreground" title={targetPath}>
+							{targetPath}
+						</dd>
+					</div>
+				{/if}
+			</dl>
+		{:else if !copied}
+			<p class="text-muted-foreground italic">Copying file…</p>
+		{/if}
+
+		<div class="flex flex-wrap items-center gap-1.5 text-caption text-muted-foreground">
+			{#if sourceProviderId}
+				<Badge variant="outline" class="max-w-full truncate font-mono text-caption">
+					{sourceProviderId}
+				</Badge>
+			{/if}
+			{#if targetProviderId && targetProviderId !== sourceProviderId}
+				<Badge variant="outline" class="max-w-full truncate font-mono text-caption">
+					{targetProviderId}
+				</Badge>
+			{/if}
+			{#if sizeBytes !== null}
+				<span class="tabular-nums">{fmtSize(sizeBytes)}</span>
+			{/if}
+			{#if contentType}
+				<span class="font-mono">{contentType}</span>
+			{/if}
+		</div>
+		{#if message}
+			<p class="text-caption text-muted-foreground">{message}</p>
+		{/if}
+	</ToolCardBody>
+</ToolCard>

package/dist/svelte/tool-widgets/StorageCopyToolCard.svelte.d.ts

@@ -0,0 +1,9 @@
+/**
+     * Designed widget for `storage.copy`. Reads input while the copy is in
+     * flight and output once it finishes so common copy actions stay designed.
+     */
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const StorageCopyToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type StorageCopyToolCard = ReturnType<typeof StorageCopyToolCard>;
+export default StorageCopyToolCard;
+//# sourceMappingURL=StorageCopyToolCard.svelte.d.ts.map

package/dist/svelte/tool-widgets/StorageCopyToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageCopyToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/StorageCopyToolCard.svelte.ts"],"names":[],"mappings":"AAGA;;;OAGI;AACJ,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAyFnD,QAAA,MAAM,mBAAmB,qDAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/svelte/tool-widgets/StorageSearchToolCard.svelte

@@ -0,0 +1,94 @@
+<script lang="ts">
+	/**
+	 * Designed widget for `storage.search`. Empty result sets, in-flight
+	 * queries, and notes stay on Kit `ToolCard`.
+	 */
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import { storageSearchWidgetView } from '../../tools/widget-views.js';
+	import { fmtSize } from './format.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const view = $derived(storageSearchWidgetView(tool.output, tool.input));
+	const query = $derived(view.query);
+	const providerId = $derived(view.providerId);
+	const driveId = $derived(view.driveId);
+	const results = $derived(view.results);
+	const notes = $derived(view.notes);
+	const searched = $derived(view.searched);
+
+	const summaryTitle = $derived(
+		results.length > 0
+			? `Found ${results.length} storage result${results.length === 1 ? '' : 's'}`
+			: query
+				? `${searched ? 'Searched' : 'Searching'} storage for "${query}"`
+				: searched
+					? 'Searched storage'
+					: 'Search storage'
+	);
+</script>
+
+<ToolCard {tool} {compact} title={summaryTitle} icon="lucide:search">
+	<ToolCardBody {compact} aria-label="Storage search result">
+		<div class="flex flex-wrap items-center gap-1.5">
+			{#if query}
+				<Badge variant="secondary" class="max-w-full truncate text-caption">{query}</Badge>
+			{/if}
+			{#if providerId}
+				<span class="truncate font-mono text-caption text-muted-foreground">{providerId}</span>
+			{/if}
+			{#if driveId}
+				<span class="truncate font-mono text-caption text-muted-foreground">{driveId}</span>
+			{/if}
+		</div>
+
+		{#if !searched}
+			<p class="text-xs text-muted-foreground italic">Searching storage…</p>
+		{:else if results.length}
+			<ul class="space-y-1.5">
+				{#each results as result (result.path)}
+					<li class="min-w-0">
+						<div class="flex items-center gap-2">
+							<Icon
+								icon={result.kind === 'directory' ? 'lucide:folder' : 'lucide:file'}
+								class="size-3.5 shrink-0 text-muted-foreground"
+							/>
+							<span class="min-w-0 flex-1 truncate text-xs font-medium text-foreground">
+								{result.name}
+							</span>
+							{#if result.sizeBytes !== undefined}
+								<span class="shrink-0 tabular-nums text-caption text-muted-foreground">
+									{fmtSize(result.sizeBytes)}
+								</span>
+							{/if}
+						</div>
+						<div class="ml-5 flex min-w-0 flex-wrap items-center gap-1.5">
+							<span class="truncate font-mono text-caption text-muted-foreground"
+								>{result.path}</span
+							>
+							{#if result.modifiedAt}
+								<span class="shrink-0 text-caption text-muted-foreground">{result.modifiedAt}</span>
+							{/if}
+						</div>
+					</li>
+				{/each}
+			</ul>
+		{:else}
+			<p class="text-xs text-muted-foreground italic">No storage results.</p>
+		{/if}
+
+		{#if notes.length}
+			<ul class="space-y-1">
+				{#each notes as note (note)}
+					<li class="text-caption text-muted-foreground">{note}</li>
+				{/each}
+			</ul>
+		{/if}
+	</ToolCardBody>
+</ToolCard>

package/dist/svelte/tool-widgets/StorageSearchToolCard.svelte.d.ts

@@ -0,0 +1,9 @@
+/**
+     * Designed widget for `storage.search`. Empty result sets, in-flight
+     * queries, and notes stay on Kit `ToolCard`.
+     */
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const StorageSearchToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type StorageSearchToolCard = ReturnType<typeof StorageSearchToolCard>;
+export default StorageSearchToolCard;
+//# sourceMappingURL=StorageSearchToolCard.svelte.d.ts.map

package/dist/svelte/tool-widgets/StorageSearchToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageSearchToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/StorageSearchToolCard.svelte.ts"],"names":[],"mappings":"AAGA;;;OAGI;AACJ,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AA2FnD,QAAA,MAAM,qBAAqB,qDAAwC,CAAC;AACpE,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACtE,eAAe,qBAAqB,CAAC"}

package/dist/svelte/tool-widgets/format.d.ts

@@ -0,0 +1,15 @@
+/** Shared presentational helpers for storage tool cards. */
+import * as z from 'zod/v4';
+/** A widget payload object: its fields, each still to be read on its own. */
+declare const WidgetRecordSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type WidgetRecord = z.infer<typeof WidgetRecordSchema>;
+/** A payload as an object, or null when it is not one (absent, a list, a scalar). */
+export declare function rec<Value>(value: Value): WidgetRecord | null;
+/** A text field, or empty. */
+export declare function str<Value>(value: Value): string;
+export declare function fmtSize(bytes?: number | null): string;
+export declare function baseName(path: string): string;
+/** The non-empty notes of an output. */
+export declare function notesOf(value: WidgetRecord | null): string[];
+export {};
+//# sourceMappingURL=format.d.ts.map

package/dist/svelte/tool-widgets/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/format.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,6EAA6E;AAC7E,QAAA,MAAM,kBAAkB,wCAAoC,CAAC;AAC7D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAK9D,qFAAqF;AACrF,wBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,IAAI,CAE5D;AAED,8BAA8B;AAC9B,wBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAE/C;AAED,wBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKrD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,wCAAwC;AACxC,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,EAAE,CAE5D"}

package/dist/svelte/tool-widgets/format.js

@@ -0,0 +1,32 @@
+/** Shared presentational helpers for storage tool cards. */
+import * as z from 'zod/v4';
+/** A widget payload object: its fields, each still to be read on its own. */
+const WidgetRecordSchema = z.record(z.string(), z.unknown());
+const WidgetRecordOrNullSchema = WidgetRecordSchema.nullable().catch(null);
+const TextOrEmptySchema = z.string().catch('');
+const NotesSchema = z.array(z.string().catch('')).catch([]);
+/** A payload as an object, or null when it is not one (absent, a list, a scalar). */
+export function rec(value) {
+    return WidgetRecordOrNullSchema.parse(value);
+}
+/** A text field, or empty. */
+export function str(value) {
+    return TextOrEmptySchema.parse(value);
+}
+export function fmtSize(bytes) {
+    if (bytes === undefined || bytes === null || !Number.isFinite(bytes))
+        return '';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 102.4) / 10} KB`;
+    return `${Math.round(bytes / (1024 * 102.4)) / 10} MB`;
+}
+export function baseName(path) {
+    const parts = path.split('/').filter(Boolean);
+    return parts[parts.length - 1] ?? path;
+}
+/** The non-empty notes of an output. */
+export function notesOf(value) {
+    return NotesSchema.parse(value?.notes).filter((note) => note.length > 0);
+}

package/dist/svelte/tool-widgets/index.d.ts

@@ -0,0 +1,2 @@
+export { createStorageSvelteToolWidgetDescriptor, createStorageSvelteToolWidgetLoader, type StorageSvelteToolWidgetDescriptor, type StorageSvelteToolWidgetDescriptorOptions } from './runtime.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/tool-widgets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/index.ts"],"names":[],"mappings":"AAaA,OAAO,EACN,uCAAuC,EACvC,mCAAmC,EACnC,KAAK,iCAAiC,EACtC,KAAK,wCAAwC,EAC7C,MAAM,cAAc,CAAC"}

package/dist/svelte/tool-widgets/index.js

@@ -0,0 +1,12 @@
+/**
+ * Registers storage-svelte's designed tool widgets into the kit's tool-widget
+ * registry (side-effect on import). Chat hosts import this once
+ * (`import '@vibesdotdev/storage/svelte/tool-widgets'`). The svelte plugin
+ * also publishes matching `tools/ui` descriptors so runtime hydration can
+ * copy the same cards into the Kit map.
+ */
+import { registerToolWidget } from '@vibesdotdev/kit/components/tool-widgets';
+registerToolWidget('storage.browse', () => import('./StorageBrowseToolCard.svelte'));
+registerToolWidget('storage.copy', () => import('./StorageCopyToolCard.svelte'));
+registerToolWidget('storage.search', () => import('./StorageSearchToolCard.svelte'));
+export { createStorageSvelteToolWidgetDescriptor, createStorageSvelteToolWidgetLoader } from "./runtime.js";

package/dist/svelte/tool-widgets/runtime.d.ts

@@ -0,0 +1,9 @@
+import type { ToolWidgetLoader } from '@vibesdotdev/kit/components/tool-widgets';
+export type { StorageSvelteToolWidgetDescriptor } from '../../schemas/tools/widgets.ts';
+import type { StorageSvelteToolWidgetDescriptor } from '../../schemas/tools/widgets.ts';
+export type { StorageSvelteToolWidgetDescriptorOptions } from '../../schemas/tools/widgets.ts';
+import type { StorageSvelteToolWidgetDescriptorOptions } from '../../schemas/tools/widgets.ts';
+export declare function createStorageSvelteToolWidgetDescriptor(options: StorageSvelteToolWidgetDescriptorOptions): StorageSvelteToolWidgetDescriptor;
+export declare function registerStorageSvelteToolWidget(descriptor: StorageSvelteToolWidgetDescriptor, load: ToolWidgetLoader): Promise<void>;
+export declare function createStorageSvelteToolWidgetLoader(descriptor: StorageSvelteToolWidgetDescriptor, load: ToolWidgetLoader): import("@vibesdotdev/kernel").AssetLoader;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/svelte/tool-widgets/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/runtime.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,YAAY,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAExF,YAAY,EAAE,wCAAwC,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,gCAAgC,CAAC;AAE/F,wBAAgB,uCAAuC,CACtD,OAAO,EAAE,wCAAwC,GAC/C,iCAAiC,CAgBnC;AAED,wBAAsB,+BAA+B,CACpD,UAAU,EAAE,iCAAiC,EAC7C,IAAI,EAAE,gBAAgB,GACpB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAgB,mCAAmC,CAClD,UAAU,EAAE,iCAAiC,EAC7C,IAAI,EAAE,gBAAgB,6CAWtB"}

package/dist/svelte/tool-widgets/runtime.js

@@ -0,0 +1,42 @@
+/**
+ * Storage-owned Svelte `tools/ui` helpers.
+ *
+ * Duplicates the Kit-bridge in `@vibesdotdev/tools/svelte/tool-widgets` because
+ * tools depends on storage — importing it back would close a workspace cycle.
+ * Descriptors still match `tools/ui` so Chat can hydrate widgets from runtime.
+ */
+import { createRuntimeImplementation, loader } from '@vibesdotdev/kernel';
+export function createStorageSvelteToolWidgetDescriptor(options) {
+    const descriptor = {
+        id: options.id ?? `${options.toolId}.svelte-widget`,
+        kind: 'tools/ui',
+        name: options.name ?? `${options.toolId} Svelte Widget`,
+        description: options.description ?? `Renders ${options.toolId} tool results in Svelte surfaces.`,
+        surfaces: ['web'],
+        role: 'widget',
+        targetToolId: options.toolId,
+        targetId: options.toolId,
+        tags: options.tags ?? ['storage', 'widget'],
+        enabled: true
+    };
+    if (options.placement)
+        descriptor.placement = options.placement;
+    return descriptor;
+}
+export async function registerStorageSvelteToolWidget(descriptor, load) {
+    const { registerToolWidget } = await import('@vibesdotdev/kit/components/tool-widgets');
+    registerToolWidget(descriptor.targetToolId, load, descriptor.placement && descriptor.placement !== 'inline'
+        ? { placement: descriptor.placement }
+        : undefined);
+}
+export function createStorageSvelteToolWidgetLoader(descriptor, load) {
+    return loader(descriptor.id, { kind: 'tools/ui', scope: 'browser' }, async () => {
+        await registerStorageSvelteToolWidget(descriptor, load);
+        const module = await load();
+        return createRuntimeImplementation({
+            kind: 'tools/ui',
+            id: descriptor.id,
+            implementation: { web: { component: module.default } }
+        });
+    });
+}

package/dist/sync/cloud-document.d.ts

@@ -0,0 +1,24 @@
+export { SyncDocumentSchema, type SyncDocument } from '../schemas/sync/document.ts';
+import type { ValueFreeFailure, VibesRuntime } from '@vibesdotdev/kernel';
+import type { StorageAdapterInterface } from '../interfaces/adapter.ts';
+import { type StorageManifestDescriptor } from '../schemas/manifest-descriptor.ts';
+/** The registered descriptor of `manifestId`, or undefined. */
+export declare function manifestDescriptorOf(runtime: VibesRuntime, manifestId: string): StorageManifestDescriptor | undefined;
+/** The cloud adapter, resolved by kind, or undefined when this runtime composes none. */
+export declare function cloudAdapterOf(runtime: VibesRuntime): Promise<StorageAdapterInterface | undefined>;
+/**
+ * The cloud document store for `descriptor` on `runtime`: the adapter is
+ * configured with the manifest's declared `adapterConfig['storage.cloud-api']`
+ * (owner app, endpoint) and this runtime, which resolves the owner origin and
+ * credentials, and its endpoint override is registered.
+ */
+export declare function cloudStoreFor(adapter: StorageAdapterInterface, descriptor: StorageManifestDescriptor, runtime: VibesRuntime): Promise<import("../index.ts").StorageDocumentStoreInterface<unknown>>;
+/**
+ * What a sync failure is recorded as (sync state, `vibes storage sync
+ * status`, results): a fixed prefix and the failure's value-free facts
+ * (class, code, reason), never its text, which can echo a remote body, URL or
+ * token.
+ */
+export declare function syncFailureLine(prefix: string, facts: ValueFreeFailure): string;
+export { failureOf } from '../utils/failure-of.ts';
+//# sourceMappingURL=cloud-document.d.ts.map

package/dist/sync/cloud-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-document.d.ts","sourceRoot":"","sources":["../../src/sync/cloud-document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAUpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAsC,KAAK,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAQvH,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAErH;AAED,yFAAyF;AACzF,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAGxG;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,yBAAyB,EAAE,OAAO,EAAE,YAAY,yEAMjI;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAE/E;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/sync/cloud-document.js

@@ -0,0 +1,47 @@
+export { SyncDocumentSchema } from "../schemas/sync/document.js";
+/**
+ * The cloud side of a manifest sync, shared by `syncManifest` and
+ * `pullFromCloud`: the manifest's descriptor, the cloud adapter resolved by
+ * kind, its document store (endpoint override registered), the document as
+ * JSON, and how a failure is recorded (value-free facts, never thrown text).
+ */
+import { ZodSchemaValueSchema } from "../schemas/zod-schema-value.js";
+import { StorageCloudApiAdapterConfigSchema } from "../schemas/manifest-descriptor.js";
+/** A synced document: what a manifest stores is JSON (it is hashed and sent over REST). */
+/** A manifest's declared schema, as the cloud adapter's document store takes it. */
+import { extractCloudEndpoint, registerCloudEndpointIfSupported } from "../schemas/cloud-endpoints.js";
+const ManifestDocumentSchemaSchema = ZodSchemaValueSchema;
+/** The registered descriptor of `manifestId`, or undefined. */
+export function manifestDescriptorOf(runtime, manifestId) {
+    return runtime.query('storage/manifest').withId(manifestId).descriptors()[0];
+}
+/** The cloud adapter, resolved by kind, or undefined when this runtime composes none. */
+export async function cloudAdapterOf(runtime) {
+    if (runtime.query('storage/adapter').withId('storage.cloud-api').descriptors().length === 0)
+        return undefined;
+    return runtime.query('storage/adapter').withId('storage.cloud-api').resolve();
+}
+/**
+ * The cloud document store for `descriptor` on `runtime`: the adapter is
+ * configured with the manifest's declared `adapterConfig['storage.cloud-api']`
+ * (owner app, endpoint) and this runtime, which resolves the owner origin and
+ * credentials, and its endpoint override is registered.
+ */
+export async function cloudStoreFor(adapter, descriptor, runtime) {
+    adapter.configure({ ...StorageCloudApiAdapterConfigSchema.parse(descriptor.adapterConfig?.['storage.cloud-api'] ?? {}), runtime });
+    const endpoint = extractCloudEndpoint(descriptor.adapterConfig);
+    registerCloudEndpointIfSupported(adapter, descriptor.namespace, endpoint);
+    await adapter.ensureReady();
+    return adapter.documentStore(descriptor.namespace, ManifestDocumentSchemaSchema.parse(descriptor.schema), descriptor);
+}
+/**
+ * What a sync failure is recorded as (sync state, `vibes storage sync
+ * status`, results): a fixed prefix and the failure's value-free facts
+ * (class, code, reason), never its text, which can echo a remote body, URL or
+ * token.
+ */
+export function syncFailureLine(prefix, facts) {
+    return [prefix, facts.name, facts.code, facts.reason].filter((part) => part !== undefined).join(' ');
+}
+export { failureOf } from "../utils/failure-of.js";
+//# sourceMappingURL=cloud-document.js.map

package/dist/sync/cloud-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-document.js","sourceRoot":"","sources":["../../src/sync/cloud-document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAqB,MAAM,6BAA6B,CAAC;AACpF;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAItE,OAAO,EAAE,kCAAkC,EAAkC,MAAM,mCAAmC,CAAC;AAEvH,2FAA2F;AAE3F,oFAAoF;AACpF,OAAO,EAAE,oBAAoB,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACvG,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAE1D,+DAA+D;AAC/D,MAAM,UAAU,oBAAoB,CAAC,OAAqB,EAAE,UAAkB;IAC7E,OAAO,OAAO,CAAC,KAAK,CAA4B,kBAAkB,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAqB;IACzD,IAAI,OAAO,CAAC,KAAK,CAA2B,iBAAiB,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxI,OAAO,OAAO,CAAC,KAAK,CAAoD,iBAAiB,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,OAAO,EAAE,CAAC;AAClI,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgC,EAAE,UAAqC,EAAE,OAAqB;IACjI,OAAO,CAAC,SAAS,CAAC,EAAE,GAAG,kCAAkC,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACnI,MAAM,QAAQ,GAAG,oBAAoB,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAChE,gCAAgC,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1E,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5B,OAAO,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,SAAS,EAAE,4BAA4B,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;AACvH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,KAAuB;IACtE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtG,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/sync/cloud-pull.d.ts

@@ -4,12 +4,18 @@
  * Pulls data from cloud storage for manifests that have cloud-api configured.
  * Used at daemon startup to hydrate local state from cloud, and by the
  * sync job for bidirectional sync.
+ *
+ * An unreachable cloud is an error, not a skip, and every failure is recorded
+ * (sync state, the result) as its value-free facts, never a thrown text.
+ * A failure of the pull as a whole (sync state unreadable, adapter
+ * unresolvable) refuses typed: it is never answered as an empty result.
  */
-import type { CloudPullOptions, CloudPullResult } from './schemas/cloud-pull';
-export type { CloudPullOptions, CloudPullResult } from './schemas/cloud-pull';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { CloudPullOptions, CloudPullResult } from './schemas/cloud-pull.ts';
+export type { CloudPullDetail, CloudPullOptions, CloudPullResult } from './schemas/cloud-pull.ts';
 /**
  * Pull data from cloud for all eligible manifests.
  * Called at daemon startup and periodically by the sync job.
  */
-export declare function pullFromCloud(options?: CloudPullOptions): Promise<CloudPullResult>;
+export declare function pullFromCloud(runtime: VibesRuntime, options?: CloudPullOptions): Promise<CloudPullResult>;
 //# sourceMappingURL=cloud-pull.d.ts.map

package/dist/sync/cloud-pull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-pull.d.ts","sourceRoot":"","sources":["../../src/sync/cloud-pull.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAW9E,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI9E;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAoG5F"}
+{"version":3,"file":"cloud-pull.d.ts","sourceRoot":"","sources":["../../src/sync/cloud-pull.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA0D,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGhH,OAAO,KAAK,EAAmB,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAclG,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAIlG;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqDnH"}