@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

package/dist/backup/targets/presence-identity.target.descriptor.js

@@ -0,0 +1,40 @@
+/**
+ * Default backup target — agent identity files.
+ *
+ * Without `.key` and `identity.json`, the inner.db is encrypted ciphertext
+ * and unreadable. Backing these up is half of the recovery story.
+ */
+const descriptor = {
+    kind: "backup/target",
+    id: "presence.identity",
+    name: "Presence Identity",
+    description: "Agent encryption key (`.key`) + optional `identity.json` config. Required to decrypt inner.db — losing this makes the inner-world snapshot unreadable.",
+    owner: "presence",
+    source: {
+        kind: "file",
+        // The key beside each home's inner world; without it that snapshot is unreadable.
+        path: "{agentHome}/.key",
+        agentHomes: { root: "{vibesHome}/homes", marker: "inner.db" },
+        sidecars: ["identity.json"],
+        required: true,
+    },
+    rotation: {
+        keepDaily: 7,
+        keepWeekly: 8,
+        keepMonthly: 12,
+        keepForever: true,
+    },
+    verify: {
+        requiredTables: [],
+    },
+    tags: [
+        "presence",
+        "identity",
+        "crypto-key",
+        "irreplaceable",
+        "priority:critical",
+    ],
+    enabled: true,
+};
+export default descriptor;
+//# sourceMappingURL=presence-identity.target.descriptor.js.map

package/dist/backup/targets/presence-identity.target.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-identity.target.descriptor.js","sourceRoot":"","sources":["../../../src/backup/targets/presence-identity.target.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,GAA2B;IACzC,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,wJAAwJ;IAC1J,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,kFAAkF;QAClF,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,EAAE;QAC7D,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,QAAQ,EAAE,IAAI;KACf;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,EAAE;KACnB;IACD,IAAI,EAAE;QACJ,UAAU;QACV,UAAU;QACV,YAAY;QACZ,eAAe;QACf,mBAAmB;KACpB;IACD,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/backup/targets/presence-inner.target.descriptor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Default backup target — encrypted inner-world memory store.
+ *
+ * This is the irreplaceable one. Loss of this = loss of every entry the
+ * agent ever wrote about itself, its relationships, its discoveries.
+ */
+import type { BackupTargetDescriptor } from "../schemas/target.ts";
+declare const descriptor: BackupTargetDescriptor;
+export default descriptor;
+//# sourceMappingURL=presence-inner.target.descriptor.d.ts.map

package/dist/backup/targets/presence-inner.target.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-inner.target.descriptor.d.ts","sourceRoot":"","sources":["../../../src/backup/targets/presence-inner.target.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,QAAA,MAAM,UAAU,EAAE,sBA4BjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/backup/targets/presence-inner.target.descriptor.js

@@ -0,0 +1,36 @@
+/**
+ * Default backup target — encrypted inner-world memory store.
+ *
+ * This is the irreplaceable one. Loss of this = loss of every entry the
+ * agent ever wrote about itself, its relationships, its discoveries.
+ */
+const descriptor = {
+    kind: "backup/target",
+    id: "presence.inner",
+    name: "Presence Inner World",
+    description: "Encrypted SQLite store of agent memories (thoughts, feelings, dreams, term coinages)",
+    owner: "presence",
+    source: {
+        kind: "sqlite",
+        // Every agent home (`{vibesHome}/homes/<ownerType>/<ownerId>/agents/<agentId>/`),
+        // where presence keeps each inner world since the 2026-09-22 home move.
+        path: "{agentHome}/inner.db",
+        agentHomes: { root: "{vibesHome}/homes", marker: "inner.db" },
+        sidecars: [],
+        required: true,
+    },
+    rotation: {
+        keepDaily: 7,
+        keepWeekly: 8,
+        keepMonthly: 12,
+        keepForever: true,
+    },
+    verify: {
+        minRows: 1,
+        requiredTables: ["inner_world"],
+    },
+    tags: ["presence", "inner-world", "irreplaceable", "priority:critical"],
+    enabled: true,
+};
+export default descriptor;
+//# sourceMappingURL=presence-inner.target.descriptor.js.map

package/dist/backup/targets/presence-inner.target.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-inner.target.descriptor.js","sourceRoot":"","sources":["../../../src/backup/targets/presence-inner.target.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,GAA2B;IACzC,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,sFAAsF;IACxF,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,kFAAkF;QAClF,wEAAwE;QACxE,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,EAAE;QAC7D,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,IAAI;KACf;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,OAAO,EAAE,CAAC;QACV,cAAc,EAAE,CAAC,aAAa,CAAC;KAChC;IACD,IAAI,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,CAAC;IACvE,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/backup/targets/storage-records.target.descriptor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Default backup target — storage's own local records database.
+ *
+ * `{vibesHome}/vibes-storage.db` is where the LocalDB adapter keeps every
+ * global document, key-value entry and repository row a manifest or record
+ * stores without naming its own database. Storage owns it, so storage
+ * registers its `backup/target`, on the same daily snapshot, verification and
+ * retention as the presence and awareness targets. A SQLite snapshot is a
+ * consistent `VACUUM INTO` copy, so the WAL and shared-memory files are not
+ * part of it.
+ */
+import type { BackupTargetDescriptor } from "../schemas/target.ts";
+export declare const STORAGE_RECORDS_BACKUP_TARGET_ID = "storage.records";
+declare const descriptor: BackupTargetDescriptor;
+export default descriptor;
+//# sourceMappingURL=storage-records.target.descriptor.d.ts.map

package/dist/backup/targets/storage-records.target.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-records.target.descriptor.d.ts","sourceRoot":"","sources":["../../../src/backup/targets/storage-records.target.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,eAAO,MAAM,gCAAgC,oBAAoB,CAAC;AAElE,QAAA,MAAM,UAAU,EAAE,sBAuBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/backup/targets/storage-records.target.descriptor.js

@@ -0,0 +1,38 @@
+/**
+ * Default backup target — storage's own local records database.
+ *
+ * `{vibesHome}/vibes-storage.db` is where the LocalDB adapter keeps every
+ * global document, key-value entry and repository row a manifest or record
+ * stores without naming its own database. Storage owns it, so storage
+ * registers its `backup/target`, on the same daily snapshot, verification and
+ * retention as the presence and awareness targets. A SQLite snapshot is a
+ * consistent `VACUUM INTO` copy, so the WAL and shared-memory files are not
+ * part of it.
+ */
+export const STORAGE_RECORDS_BACKUP_TARGET_ID = "storage.records";
+const descriptor = {
+    kind: "backup/target",
+    id: STORAGE_RECORDS_BACKUP_TARGET_ID,
+    name: "Local Storage Records",
+    description: "Global documents, key-value entries and repository rows kept by the LocalDB adapter (vibes-storage.db)",
+    owner: "storage",
+    source: {
+        kind: "sqlite",
+        path: "{vibesHome}/vibes-storage.db",
+        sidecars: [],
+        required: false,
+    },
+    rotation: {
+        keepDaily: 7,
+        keepWeekly: 4,
+        keepMonthly: 6,
+        keepForever: false,
+    },
+    verify: {
+        requiredTables: ["vibes_documents", "vibes_kv", "vibes_repository"],
+    },
+    tags: ["storage", "records", "priority:high"],
+    enabled: true,
+};
+export default descriptor;
+//# sourceMappingURL=storage-records.target.descriptor.js.map

package/dist/backup/targets/storage-records.target.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-records.target.descriptor.js","sourceRoot":"","sources":["../../../src/backup/targets/storage-records.target.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,CAAC,MAAM,gCAAgC,GAAG,iBAAiB,CAAC;AAElE,MAAM,UAAU,GAA2B;IACzC,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,gCAAgC;IACpC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,wGAAwG;IACrH,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,8BAA8B;QACpC,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,KAAK;KAChB;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,KAAK;KACnB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,CAAC,iBAAiB,EAAE,UAAU,EAAE,kBAAkB,CAAC;KACpE;IACD,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC;IAC7C,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/bridge/index.d.ts

@@ -1,3 +1,3 @@
-export { bridgeStorageKinds } from './storage-kind-bridge';
-export type { StorageKindBridgeConfig } from './types';
+export { bridgeStorageKinds } from './storage-kind-bridge.ts';
+export type { StorageKindBridgeConfig } from './types.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/bridge/index.js

@@ -1,2 +1,2 @@
-export { bridgeStorageKinds } from './storage-kind-bridge.js';
+export { bridgeStorageKinds } from "./storage-kind-bridge.js";
 //# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/bridge/storage-kind-bridge.d.ts

@@ -8,7 +8,18 @@
  *
  * This runs at boot after discovery completes and storage adapters are available.
  */
-import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
+import * as z from 'zod/v4';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+/** A `providesRuntimeKinds` entry as declared: its descriptor mapping, optional loader class and filter. */
+export declare const StorageKindBridgeConfigSchema: z.ZodObject<{
+    toDescriptor: z.ZodCustom<(item: unknown) => import("@vibesdotdev/kernel").RuntimeDescriptor, (item: unknown) => import("@vibesdotdev/kernel").RuntimeDescriptor>;
+    implementation: z.ZodOptional<z.ZodCustom<new (descriptor: import("@vibesdotdev/kernel").RuntimeDescriptor, context: {
+        runtime: RuntimeRef;
+    }) => object, new (descriptor: import("@vibesdotdev/kernel").RuntimeDescriptor, context: {
+        runtime: RuntimeRef;
+    }) => object>>;
+    filter: z.ZodOptional<z.ZodCustom<(item: unknown) => boolean, (item: unknown) => boolean>>;
+}, z.core.$strip>;
 /**
  * Bridge storage manifest items into runtime kind registries.
  *
@@ -20,7 +31,7 @@ import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
  *
  * @returns Count of bridged items and any errors encountered
  */
-export declare function bridgeStorageKinds(runtime: VibesRuntime): Promise<{
+export declare function bridgeStorageKinds(runtime: RuntimeRef): Promise<{
     bridged: number;
     errors: string[];
 }>;

package/dist/bridge/storage-kind-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-kind-bridge.d.ts","sourceRoot":"","sources":["../../src/bridge/storage-kind-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAMrE;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoGhD"}
+{"version":3,"file":"storage-kind-bridge.d.ts","sourceRoot":"","sources":["../../src/bridge/storage-kind-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQtD,4GAA4G;AAC5G,eAAO,MAAM,6BAA6B;;;;;;;;iBAIxC,CAAC;AAuEH;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0BhD"}

package/dist/bridge/storage-kind-bridge.js

@@ -8,8 +8,76 @@
  *
  * This runs at boot after discovery completes and storage adapters are available.
  */
-import { StorageManifest } from '../manifest/base.js';
-import { createTracer } from '@vibesdotdev/runtime/debug';
+import * as z from 'zod/v4';
+import { StorageManifest } from "../manifest/base.js";
+import { createTracer } from '@vibesdotdev/kernel/debug';
+import { syncFailureLine } from "../sync/cloud-document.js";
+import { failureOf, failureOfSync } from "../utils/failure-of.js";
+/** A `providesRuntimeKinds` entry as declared: its descriptor mapping, optional loader class and filter. */
+export const StorageKindBridgeConfigSchema = z.object({
+    toDescriptor: z.custom((value) => value instanceof Function),
+    implementation: z.custom((value) => value instanceof Function).optional(),
+    filter: z.custom((value) => value instanceof Function).optional()
+});
+/** A manifest's stored document as loaded (its items are parsed below). */
+const StoredDocumentSchema = z.unknown();
+/** A stored document's bridgeable items: an array's entries, an object's values, else the value itself. */
+const StoredItemsSchema = z.union([z.array(z.unknown()), z.record(z.string(), z.unknown()).transform((record) => Object.values(record)), z.unknown().transform((value) => [value])]);
+/** Bridge one manifest's stored items into the kinds it declares. */
+async function bridgeManifest(runtime, manifest) {
+    const outcome = { bridged: 0, errors: [] };
+    const bridgeConfig = manifest.providesRuntimeKinds;
+    if (!bridgeConfig)
+        return outcome;
+    const manifestTracer = createTracer(`manifest:${manifest.id}`);
+    manifestTracer.start();
+    let data = null;
+    const loadFailure = await failureOf(async () => {
+        data = await StorageManifest.fromId(manifest.id, runtime).load();
+    });
+    if (loadFailure) {
+        manifestTracer.end('failed');
+        outcome.errors.push(syncFailureLine(`Failed to load storage '${manifest.id}':`, loadFailure));
+        return outcome;
+    }
+    if (!data) {
+        manifestTracer.end('no data');
+        return outcome;
+    }
+    const items = StoredItemsSchema.parse(data);
+    manifestTracer.end(`loaded ${items.length} items`);
+    for (const [kindId, rawConfig] of Object.entries(bridgeConfig)) {
+        if (!runtime.hasKind(kindId)) {
+            outcome.errors.push(`Storage '${manifest.id}' declares providesRuntimeKinds for unregistered kind '${kindId}'`);
+            continue;
+        }
+        const parsedConfig = StorageKindBridgeConfigSchema.safeParse(rawConfig);
+        if (!parsedConfig.success) {
+            outcome.errors.push(`Storage '${manifest.id}' declares an invalid providesRuntimeKinds entry for '${kindId}'`);
+            continue;
+        }
+        const config = parsedConfig.data;
+        for (const item of items) {
+            const itemFailure = failureOfSync(() => {
+                if (config.filter && !config.filter(item))
+                    return;
+                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
+                    }));
+                }
+                outcome.bridged++;
+            });
+            if (itemFailure)
+                outcome.errors.push(syncFailureLine(`Failed to bridge item from '${manifest.id}' to '${kindId}':`, itemFailure));
+        }
+    }
+    return outcome;
+}
 /**
  * Bridge storage manifest items into runtime kind registries.
  *
@@ -28,76 +96,11 @@ export async function bridgeStorageKinds(runtime) {
         bridgeTracer.end('no storage/manifest kind');
         return { bridged: 0, errors: [] };
     }
-    const manifests = runtime.assets('storage/manifest').descriptors();
+    const manifests = runtime.query('storage/manifest').descriptors();
     let bridged = 0;
     const errors = [];
     // Process manifests in parallel to reduce I/O wait time
-    const manifestPromises = manifests.map(async (manifest) => {
-        const storageManifest = manifest;
-        const bridgeConfig = storageManifest.providesRuntimeKinds;
-        if (!bridgeConfig)
-            return { bridged: 0, errors: [] };
-        const manifestTracer = createTracer(`manifest:${manifest.id}`);
-        manifestTracer.start();
-        let items;
-        try {
-            const storage = StorageManifest.fromId(manifest.id);
-            const data = await storage.load();
-            if (!data) {
-                manifestTracer.end('no data');
-                return { bridged: 0, errors: [] };
-            }
-            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 = [];
-        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;
-            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 };
-    });
+    const manifestPromises = manifests.map((manifest) => bridgeManifest(runtime, manifest));
     // Wait for all manifest processing to complete
     const results = await Promise.all(manifestPromises);
     for (const result of results) {

package/dist/bridge/storage-kind-bridge.js.map

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

package/dist/bridge/types.d.ts

@@ -4,7 +4,8 @@
  * Type-safe configuration for bridging storage manifest items
  * into runtime kind queries.
  */
-import type { RuntimeDescriptor } from '@vibesdotdev/runtime/schemas/descriptor';
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
 /**
  * Configuration for bridging stored items to a runtime kind.
  *
@@ -33,8 +34,8 @@ export interface StorageKindBridgeConfig<TStored = unknown> {
      * is used instead.
      */
     implementation?: new (descriptor: RuntimeDescriptor, context: {
-        runtime: unknown;
-    }) => unknown;
+        runtime: RuntimeRef;
+    }) => object;
     /**
      * Filter which stored items to bridge.
      * Return true to include the item, false to skip.

package/dist/bridge/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO,GAAG,OAAO;IACzD,sEAAsE;IACtE,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,iBAAiB,CAAC;IAEnD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,KAAK,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;IAE/F;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO,GAAG,OAAO;IACzD,sEAAsE;IACtE,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,iBAAiB,CAAC;IAEnD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,KAAK,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,KAAK,MAAM,CAAC;IAEjG;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;CACpC"}

package/dist/cli/backup/backup.cli-group.descriptor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Backup CLI Group Descriptor
+ *
+ * `vibes backup` — snapshot, list, verify backup targets.
+ */
+type CLIGroupAssetDescriptor = import('@vibesdotdev/cli-contracts/descriptors').CLIGroupAssetDescriptor;
+declare const descriptor: CLIGroupAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=backup.cli-group.descriptor.d.ts.map

package/dist/cli/backup/backup.cli-group.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.cli-group.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/backup/backup.cli-group.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,uBAAuB,GAAG,OAAO,wCAAwC,EAAE,uBAAuB,CAAC;AACxG,QAAA,MAAM,UAAU,EAAE,uBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/backup/backup.cli-group.descriptor.js

@@ -0,0 +1,16 @@
+/**
+ * Backup CLI Group Descriptor
+ *
+ * `vibes backup` — snapshot, list, verify backup targets.
+ */
+const descriptor = {
+    kind: "cli/group",
+    id: "backup",
+    name: "backup",
+    description: "Snapshot and verify backup targets (presence, awareness, more)",
+    surfaces: ["cli"],
+    hardware: ["consumer", "cloud"],
+    enabled: true,
+};
+export default descriptor;
+//# sourceMappingURL=backup.cli-group.descriptor.js.map

package/dist/cli/backup/backup.cli-group.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.cli-group.descriptor.js","sourceRoot":"","sources":["../../../src/cli/backup/backup.cli-group.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,MAAM,UAAU,GAA4B;IAC1C,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,gEAAgE;IAC7E,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/backup/commands/backup.now.cli-command.descriptor.d.ts

@@ -0,0 +1,4 @@
+type CLICommandAssetDescriptor = import('@vibesdotdev/cli-contracts/descriptors').CLICommandAssetDescriptor;
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=backup.now.cli-command.descriptor.d.ts.map

package/dist/cli/backup/commands/backup.now.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.now.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.now.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,KAAK,yBAAyB,GAAG,OAAO,wCAAwC,EAAE,yBAAyB,CAAC;AAC5G,QAAA,MAAM,UAAU,EAAE,yBAqBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/backup/commands/backup.now.cli-command.descriptor.js

@@ -0,0 +1,24 @@
+const descriptor = {
+    kind: "cli/command",
+    id: "backup.now",
+    name: "now",
+    description: "Run a snapshot immediately for one or all targets",
+    group: "backup",
+    options: [
+        {
+            flags: "-t, --target <id>",
+            description: "Snapshot a single target by id",
+        },
+        { flags: "--skip-hash", description: "Skip sha256 hashing (faster)" },
+        {
+            flags: "--dry-run",
+            description: "Show what would be snapshotted without writing",
+        },
+        { flags: "--json", description: "Output as JSON" },
+    ],
+    surfaces: ["cli"],
+    hardware: ["consumer", "cloud"],
+    enabled: true,
+};
+export default descriptor;
+//# sourceMappingURL=backup.now.cli-command.descriptor.js.map

package/dist/cli/backup/commands/backup.now.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.now.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.now.cli-command.descriptor.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,GAA8B;IAC5C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,mDAAmD;IAChE,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE;QACP;YACE,KAAK,EAAE,mBAAmB;YAC1B,WAAW,EAAE,gCAAgC;SAC9C;QACD,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,8BAA8B,EAAE;QACrE;YACE,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,gDAAgD;SAC9D;QACD,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;KACnD;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/backup/commands/backup.now.cli-command.impl.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `vibes backup now` — run snapshots immediately.
+ *
+ * Dispatches `backup.snapshot` through the workers client onto its queue and
+ * waits for the result, so the snapshot runs on the durable worker runtime
+ * and the terminal still shows what it did.
+ */
+import * as z from "zod/v4";
+import type { CommandContext } from "@vibesdotdev/cli-contracts";
+import { type SnapshotJobInput, type SnapshotJobOutput } from "../../../backup/jobs/backup.snapshot.schema.ts";
+/** The slice of the Workers runtime client (`runtime/client#workers`) this command dispatches through. */
+export interface BackupNowWorkersClient {
+    runJob(job: string, data: SnapshotJobInput): Promise<SnapshotJobOutput>;
+}
+/** The command's options, parsed at the boundary (commander camel-cases `--skip-hash` / `--dry-run`). */
+declare const BackupNowOptionsSchema: z.ZodObject<{
+    target: z.ZodOptional<z.ZodString>;
+    skipHash: z.ZodOptional<z.ZodBoolean>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const _default: {
+    execute(_args: Record<string, never>, opts: z.input<typeof BackupNowOptionsSchema>, context: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=backup.now.cli-command.impl.d.ts.map

package/dist/cli/backup/commands/backup.now.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.now.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.now.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAA2B,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAGxI,0GAA0G;AAC1G,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACzE;AAED,yGAAyG;AACzG,QAAA,MAAM,sBAAsB;;;;;iBAK1B,CAAC;;mBAIQ,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QACtB,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,WACnC,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC;;AALlB,wBA2DE"}

package/dist/cli/backup/commands/backup.now.cli-command.impl.js

@@ -0,0 +1,61 @@
+/**
+ * `vibes backup now` — run snapshots immediately.
+ *
+ * Dispatches `backup.snapshot` through the workers client onto its queue and
+ * waits for the result, so the snapshot runs on the durable worker runtime
+ * and the terminal still shows what it did.
+ */
+import * as z from "zod/v4";
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { SnapshotJobOutputSchema } from "../../../backup/jobs/backup.snapshot.schema.js";
+import { resolveWorkersClient, WorkersRunClientSchema } from "../../../workers-port.js";
+/** The command's options, parsed at the boundary (commander camel-cases `--skip-hash` / `--dry-run`). */
+const BackupNowOptionsSchema = z.object({
+    target: z.string().optional(),
+    skipHash: z.boolean().optional(),
+    dryRun: z.boolean().optional(),
+    json: z.boolean().optional(),
+});
+export default {
+    async execute(_args, opts, context) {
+        const runtime = context.runtime;
+        const ui = await runtime.context("cli/ui");
+        const options = BackupNowOptionsSchema.parse(opts);
+        const workers = await resolveWorkersClient(runtime, WorkersRunClientSchema);
+        const data = { skipHash: options.skipHash ?? false, dryRun: options.dryRun ?? false };
+        if (options.target)
+            data.targetId = options.target;
+        const answered = SnapshotJobOutputSchema.safeParse(await workers.runJob("backup.snapshot", data));
+        if (!answered.success) {
+            throw new CapabilityError("The backup.snapshot job answered in an unexpected shape.", "INTERNAL", { reason: "backup-snapshot-output-invalid", retryable: false });
+        }
+        const result = answered.data;
+        if (options.json) {
+            ui.render(result, { format: "json" });
+            return;
+        }
+        ui.info(`\nSnapshot run: attempted=${result.targetsAttempted} succeeded=${result.targetsSucceeded} failed=${result.targetsFailed} empty=${result.targetsEmpty}`);
+        if (result.results.length === 0) {
+            ui.warn("No backup targets matched.");
+            return;
+        }
+        for (const run of result.results) {
+            const label = run.home ? `${run.targetId} (${run.home})` : run.targetId;
+            if (run.status === "empty") {
+                ui.warn(`${label}: none of the target's declared files exist; nothing was backed up.`);
+            }
+            for (const notice of run.notices) {
+                ui.warn(`${label}: ${notice.message} [${notice.code} ${notice.reason}]`);
+            }
+        }
+        ui.table(result.results.map((r) => ({
+            target: r.targetId,
+            status: r.status,
+            files: r.files.length,
+            rows: r.rowCount ?? "—",
+            ms: r.durationMs,
+            error: r.error ?? "",
+        })), ["target", "status", "files", "rows", "ms", "error"]);
+    },
+};
+//# sourceMappingURL=backup.now.cli-command.impl.js.map

package/dist/cli/backup/commands/backup.now.cli-command.impl.js.map

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

package/dist/cli/backup/commands/backup.restore.cli-command.descriptor.d.ts

@@ -0,0 +1,4 @@
+type CLICommandAssetDescriptor = import('@vibesdotdev/cli-contracts/descriptors').CLICommandAssetDescriptor;
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=backup.restore.cli-command.descriptor.d.ts.map

package/dist/cli/backup/commands/backup.restore.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.restore.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.restore.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,KAAK,yBAAyB,GAAG,OAAO,wCAAwC,EAAE,yBAAyB,CAAC;AAC5G,QAAA,MAAM,UAAU,EAAE,yBAsBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}