@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

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

@@ -0,0 +1,19 @@
+import type { StorageTuiToolStatus } from '../../schemas/tools/views.ts';
+export type { StorageTuiToolStatus } from '../../schemas/tools/views.ts';
+import * as z from 'zod/v4';
+import type { WidgetStatus } from '@vibesdotdev/tui';
+/** 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;
+/** A byte size as display text, or empty when it is not a finite number. */
+export declare function fmtSize<Value>(raw: Value): string;
+export declare function baseName(path: string): string;
+/** The non-empty notes of an output. */
+export declare function notesOf(output: WidgetRecord | null): string[];
+export declare function widgetStatus(status: StorageTuiToolStatus): WidgetStatus;
+export declare function statusText(status: StorageTuiToolStatus): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/tui/tool-widgets/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,6EAA6E;AAC7E,QAAA,MAAM,kBAAkB,wCAAoC,CAAC;AAC7D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D,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,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,MAAM,CAMjD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,wCAAwC;AACxC,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,EAAE,CAE7D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,YAAY,CAKvE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAK/D"}

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

@@ -0,0 +1,53 @@
+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 SizeOrNullSchema = z.number().nullable().catch(null);
+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);
+}
+/** A byte size as display text, or empty when it is not a finite number. */
+export function fmtSize(raw) {
+    const value = SizeOrNullSchema.parse(raw);
+    if (value === null)
+        return '';
+    if (value < 1024)
+        return `${value} B`;
+    if (value < 1024 * 1024)
+        return `${Math.round(value / 102.4) / 10} KB`;
+    return `${Math.round(value / (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(output) {
+    return NotesSchema.parse(output?.notes).filter((note) => note.length > 0);
+}
+export function widgetStatus(status) {
+    if (status === 'done')
+        return 'success';
+    if (status === 'failed')
+        return 'error';
+    if (status === 'pending')
+        return 'pending';
+    return 'running';
+}
+export function statusText(status) {
+    if (status === 'failed')
+        return 'Failed';
+    if (status === 'pending')
+        return 'Waiting';
+    if (status === 'running')
+        return 'Executing';
+    return 'Completed';
+}
+//# sourceMappingURL=format.js.map

package/dist/tui/tool-widgets/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/tui/tool-widgets/format.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,6EAA6E;AAC7E,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAE7D,MAAM,wBAAwB,GAAG,kBAAkB,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC3E,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC/C,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC3D,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAE5D,qFAAqF;AACrF,MAAM,UAAU,GAAG,CAAQ,KAAY;IACtC,OAAO,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,GAAG,CAAQ,KAAY;IACtC,OAAO,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAQ,GAAU;IACxC,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC;IACvE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,OAAO,CAAC,MAA2B;IAClD,OAAO,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA4B;IACxD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IACxC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA4B;IACtD,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,WAAW,CAAC;AACpB,CAAC"}

package/dist/tui/tool-widgets/storage.browse.tool-widget.descriptor.d.ts

@@ -0,0 +1,14 @@
+declare const storageBrowseToolWidgetDescriptor: {
+    readonly id: "storage.browse.tui-widget";
+    readonly kind: "tools/ui";
+    readonly name: "Storage Browse TUI Widget";
+    readonly description: "Renders storage.browse drive and folder listings in terminal chat transcripts.";
+    readonly surfaces: readonly ["tui"];
+    readonly role: "widget";
+    readonly targetToolId: "storage.browse";
+    readonly targetId: "storage.browse";
+    readonly tags: readonly ["storage", "browse", "tui"];
+    readonly enabled: true;
+};
+export default storageBrowseToolWidgetDescriptor;
+//# sourceMappingURL=storage.browse.tool-widget.descriptor.d.ts.map

package/dist/tui/tool-widgets/storage.browse.tool-widget.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.browse.tool-widget.descriptor.d.ts","sourceRoot":"","sources":["../../../src/tui/tool-widgets/storage.browse.tool-widget.descriptor.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,iCAAiC;;;;;;;;;;;CAW7B,CAAC;AAEX,eAAe,iCAAiC,CAAC"}

package/dist/tui/tool-widgets/storage.browse.tool-widget.descriptor.js

@@ -0,0 +1,14 @@
+const storageBrowseToolWidgetDescriptor = {
+    id: 'storage.browse.tui-widget',
+    kind: 'tools/ui',
+    name: 'Storage Browse TUI Widget',
+    description: 'Renders storage.browse drive and folder listings in terminal chat transcripts.',
+    surfaces: ['tui'],
+    role: 'widget',
+    targetToolId: 'storage.browse',
+    targetId: 'storage.browse',
+    tags: ['storage', 'browse', 'tui'],
+    enabled: true
+};
+export default storageBrowseToolWidgetDescriptor;
+//# sourceMappingURL=storage.browse.tool-widget.descriptor.js.map

package/dist/tui/tool-widgets/storage.browse.tool-widget.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.browse.tool-widget.descriptor.js","sourceRoot":"","sources":["../../../src/tui/tool-widgets/storage.browse.tool-widget.descriptor.ts"],"names":[],"mappings":"AAAA,MAAM,iCAAiC,GAAG;IACzC,EAAE,EAAE,2BAA2B;IAC/B,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,gFAAgF;IAC7F,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,gBAAgB;IAC9B,QAAQ,EAAE,gBAAgB;IAC1B,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC;IAClC,OAAO,EAAE,IAAI;CACJ,CAAC;AAEX,eAAe,iCAAiC,CAAC"}

package/dist/tui/tool-widgets/storage.copy.tool-widget.descriptor.d.ts

@@ -0,0 +1,14 @@
+declare const storageCopyToolWidgetDescriptor: {
+    readonly id: "storage.copy.tui-widget";
+    readonly kind: "tools/ui";
+    readonly name: "Storage Copy TUI Widget";
+    readonly description: "Renders storage.copy source/target results in terminal chat transcripts.";
+    readonly surfaces: readonly ["tui"];
+    readonly role: "widget";
+    readonly targetToolId: "storage.copy";
+    readonly targetId: "storage.copy";
+    readonly tags: readonly ["storage", "copy", "tui"];
+    readonly enabled: true;
+};
+export default storageCopyToolWidgetDescriptor;
+//# sourceMappingURL=storage.copy.tool-widget.descriptor.d.ts.map

package/dist/tui/tool-widgets/storage.copy.tool-widget.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.copy.tool-widget.descriptor.d.ts","sourceRoot":"","sources":["../../../src/tui/tool-widgets/storage.copy.tool-widget.descriptor.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,+BAA+B;;;;;;;;;;;CAW3B,CAAC;AAEX,eAAe,+BAA+B,CAAC"}

package/dist/tui/tool-widgets/storage.copy.tool-widget.descriptor.js

@@ -0,0 +1,14 @@
+const storageCopyToolWidgetDescriptor = {
+    id: 'storage.copy.tui-widget',
+    kind: 'tools/ui',
+    name: 'Storage Copy TUI Widget',
+    description: 'Renders storage.copy source/target results in terminal chat transcripts.',
+    surfaces: ['tui'],
+    role: 'widget',
+    targetToolId: 'storage.copy',
+    targetId: 'storage.copy',
+    tags: ['storage', 'copy', 'tui'],
+    enabled: true
+};
+export default storageCopyToolWidgetDescriptor;
+//# sourceMappingURL=storage.copy.tool-widget.descriptor.js.map

package/dist/tui/tool-widgets/storage.copy.tool-widget.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.copy.tool-widget.descriptor.js","sourceRoot":"","sources":["../../../src/tui/tool-widgets/storage.copy.tool-widget.descriptor.ts"],"names":[],"mappings":"AAAA,MAAM,+BAA+B,GAAG;IACvC,EAAE,EAAE,yBAAyB;IAC7B,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE,0EAA0E;IACvF,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,cAAc;IACxB,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;IAChC,OAAO,EAAE,IAAI;CACJ,CAAC;AAEX,eAAe,+BAA+B,CAAC"}

package/dist/tui/tool-widgets/storage.search.tool-widget.descriptor.d.ts

@@ -0,0 +1,14 @@
+declare const storageSearchToolWidgetDescriptor: {
+    readonly id: "storage.search.tui-widget";
+    readonly kind: "tools/ui";
+    readonly name: "Storage Search TUI Widget";
+    readonly description: "Renders storage.search results in terminal chat transcripts.";
+    readonly surfaces: readonly ["tui"];
+    readonly role: "widget";
+    readonly targetToolId: "storage.search";
+    readonly targetId: "storage.search";
+    readonly tags: readonly ["storage", "search", "tui"];
+    readonly enabled: true;
+};
+export default storageSearchToolWidgetDescriptor;
+//# sourceMappingURL=storage.search.tool-widget.descriptor.d.ts.map

package/dist/tui/tool-widgets/storage.search.tool-widget.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.search.tool-widget.descriptor.d.ts","sourceRoot":"","sources":["../../../src/tui/tool-widgets/storage.search.tool-widget.descriptor.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,iCAAiC;;;;;;;;;;;CAW7B,CAAC;AAEX,eAAe,iCAAiC,CAAC"}

package/dist/tui/tool-widgets/storage.search.tool-widget.descriptor.js

@@ -0,0 +1,14 @@
+const storageSearchToolWidgetDescriptor = {
+    id: 'storage.search.tui-widget',
+    kind: 'tools/ui',
+    name: 'Storage Search TUI Widget',
+    description: 'Renders storage.search results in terminal chat transcripts.',
+    surfaces: ['tui'],
+    role: 'widget',
+    targetToolId: 'storage.search',
+    targetId: 'storage.search',
+    tags: ['storage', 'search', 'tui'],
+    enabled: true
+};
+export default storageSearchToolWidgetDescriptor;
+//# sourceMappingURL=storage.search.tool-widget.descriptor.js.map

package/dist/tui/tool-widgets/storage.search.tool-widget.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.search.tool-widget.descriptor.js","sourceRoot":"","sources":["../../../src/tui/tool-widgets/storage.search.tool-widget.descriptor.ts"],"names":[],"mappings":"AAAA,MAAM,iCAAiC,GAAG;IACzC,EAAE,EAAE,2BAA2B;IAC/B,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,8DAA8D;IAC3E,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,gBAAgB;IAC9B,QAAQ,EAAE,gBAAgB;IAC1B,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC;IAClC,OAAO,EAAE,IAAI;CACJ,CAAC;AAEX,eAAe,iCAAiC,CAAC"}

package/dist/utils/caller-bearer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The caller's bearer for storage's cross-app HTTP calls: auth's
+ * `resolveCallerBearer`, reached through the `auth/caller-bearer` context
+ * because auth depends on storage (rc05 §2.2; rc01 §3 "Bridge-key readers").
+ * The context dispatches on the runtime it was resolved from: the invocation
+ * principal on a request host, the device session on the CLI. A browser
+ * same-origin page uses credentials:include for its own origin and asks for
+ * no bearer. A host that does not compose auth fails closed resolving the
+ * context.
+ */
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+export declare function resolveStorageCallerBearer(runtime: RuntimeRef): Promise<string | null>;
+//# sourceMappingURL=caller-bearer.d.ts.map

package/dist/utils/caller-bearer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller-bearer.d.ts","sourceRoot":"","sources":["../../src/utils/caller-bearer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOtD,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAI5F"}

package/dist/utils/caller-bearer.js

@@ -0,0 +1,17 @@
+/**
+ * The caller's bearer for storage's cross-app HTTP calls: auth's
+ * `resolveCallerBearer`, reached through the `auth/caller-bearer` context
+ * because auth depends on storage (rc05 §2.2; rc01 §3 "Bridge-key readers").
+ * The context dispatches on the runtime it was resolved from: the invocation
+ * principal on a request host, the device session on the CLI. A browser
+ * same-origin page uses credentials:include for its own origin and asks for
+ * no bearer. A host that does not compose auth fails closed resolving the
+ * context.
+ */
+export async function resolveStorageCallerBearer(runtime) {
+    if (runtime.scope.surface === 'browser')
+        return null;
+    const context = await runtime.context('auth/caller-bearer');
+    return context.resolve();
+}
+//# sourceMappingURL=caller-bearer.js.map

package/dist/utils/caller-bearer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller-bearer.js","sourceRoot":"","sources":["../../src/utils/caller-bearer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAAmB;IACnE,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAsB,oBAAoB,CAAC,CAAC;IACjF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC"}

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

@@ -1,2 +1,10 @@
-export declare function toErrorContext(error: unknown): Record<string, unknown> | undefined;
+/** A log line's failure context: the caught failure's value-free facts. */
+export type { ErrorContext } from '../schemas/tools/widgets.ts';
+import type { ErrorContext } from '../schemas/tools/widgets.ts';
+/**
+ * The log context for a caught failure: its value-free facts only (class,
+ * code, reason). A failure's message, stack and cause can carry record
+ * values, keys or SQL text, so none of them is copied into a log line.
+ */
+export declare function toErrorContext<Caught>(error: Caught): ErrorContext;
 //# sourceMappingURL=error-context.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"error-context.d.ts","sourceRoot":"","sources":["../../src/utils/error-context.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAElE"}

package/dist/utils/error-context.js

@@ -1,17 +1,10 @@
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+/**
+ * The log context for a caught failure: its value-free facts only (class,
+ * code, reason). A failure's message, stack and cause can carry record
+ * values, keys or SQL text, so none of them is copied into a log line.
+ */
 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) };
+    return { error: valueFreeFailure(CaughtFailureSchema.parse(error)) };
 }
 //# sourceMappingURL=error-context.js.map

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

@@ -1 +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"}
+{"version":3,"file":"error-context.js","sourceRoot":"","sources":["../../src/utils/error-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5E;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAS,KAAa;IACnD,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC"}

package/dist/utils/failure-of.d.ts

@@ -0,0 +1,20 @@
+import { type ValueFreeFailure } from '@vibesdotdev/kernel';
+/**
+ * Run `work`; its failure's value-free facts (class, code, reason; never its
+ * text), or undefined when it succeeded. For callers that record a failure
+ * and continue (sync state, a bridge's error list, a declared-optional cache).
+ */
+export declare function failureOf(work: () => Promise<void>): Promise<ValueFreeFailure | undefined>;
+/** `failureOf` for synchronous work. */
+export declare function failureOfSync(work: () => void): ValueFreeFailure | undefined;
+/** A unit of work's outcome: its value, or its failure's value-free facts. */
+export type WorkOutcome<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    failure: ValueFreeFailure;
+};
+/** Run `work` and answer its outcome; a failure is carried as its value-free facts, never thrown. */
+export declare function outcomeOf<T>(work: () => Promise<T>): Promise<WorkOutcome<T>>;
+//# sourceMappingURL=failure-of.d.ts.map

package/dist/utils/failure-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-of.d.ts","sourceRoot":"","sources":["../../src/utils/failure-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEnG;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAOhG;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,gBAAgB,GAAG,SAAS,CAO5E;AAED,8EAA8E;AAC9E,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/F,qGAAqG;AACrG,wBAAsB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAMlF"}

package/dist/utils/failure-of.js

@@ -0,0 +1,35 @@
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+/**
+ * Run `work`; its failure's value-free facts (class, code, reason; never its
+ * text), or undefined when it succeeded. For callers that record a failure
+ * and continue (sync state, a bridge's error list, a declared-optional cache).
+ */
+export async function failureOf(work) {
+    try {
+        await work();
+        return undefined;
+    }
+    catch (error) {
+        return valueFreeFailure(CaughtFailureSchema.parse(error));
+    }
+}
+/** `failureOf` for synchronous work. */
+export function failureOfSync(work) {
+    try {
+        work();
+        return undefined;
+    }
+    catch (error) {
+        return valueFreeFailure(CaughtFailureSchema.parse(error));
+    }
+}
+/** Run `work` and answer its outcome; a failure is carried as its value-free facts, never thrown. */
+export async function outcomeOf(work) {
+    try {
+        return { ok: true, value: await work() };
+    }
+    catch (error) {
+        return { ok: false, failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+//# sourceMappingURL=failure-of.js.map

package/dist/utils/failure-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-of.js","sourceRoot":"","sources":["../../src/utils/failure-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAyB,MAAM,qBAAqB,CAAC;AAEnG;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAyB;IACxD,IAAI,CAAC;QACJ,MAAM,IAAI,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,CAAC;AACF,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC7C,IAAI,CAAC;QACJ,IAAI,EAAE,CAAC;QACP,OAAO,SAAS,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,CAAC;AACF,CAAC;AAKD,qGAAqG;AACrG,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,IAAsB;IACxD,IAAI,CAAC;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACnF,CAAC;AACF,CAAC"}

package/dist/workers-port.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Storage's view of the Workers runtime client.
+ *
+ * Workers depends on storage, so storage never imports `@vibesdotdev/workers`.
+ * The few places storage hands work to Workers (durable record delivery and
+ * `vibes backup now`) resolve the `runtime/client` kind's `workers` entry on
+ * the runtime they were handed and admit it against the narrow slice they
+ * call, declared by the caller as a schema. The composition (not an import)
+ * decides whether Workers is present.
+ *
+ * - Absent (no `runtime/client` kind, or no `workers` entry): `UNAVAILABLE`
+ *   `storage-workers-client-absent`, with the runtime's own absence as cause.
+ * - Present but not answering the slice: `INTERNAL`
+ *   `storage-workers-client-invalid`.
+ * Any other resolution failure reaches the caller unchanged.
+ */
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+/** The runtime a Workers client is resolved on: the caller's own. */
+export type StorageWorkersRuntime = Pick<RuntimeRef, 'hasKind' | 'query'>;
+/** The `runtime/client` id Workers registers its client under. */
+export declare const WORKERS_CLIENT_ID = "workers";
+/** Keyed, idempotent enqueue: the slice durable record delivery calls. */
+export declare const WorkersClaimClientSchema: z.ZodObject<{
+    startJobOnce: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+}, z.core.$strip>;
+/** Dispatch-and-wait: the slice `vibes backup now` calls. */
+export declare const WorkersRunClientSchema: z.ZodObject<{
+    runJob: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+}, z.core.$strip>;
+/**
+ * Resolve the Workers runtime client on `runtime` as the slice `TClient`
+ * declares, admitted by `slice` before it is returned. The client is returned
+ * as resolved (never a parsed copy), so its methods keep their receiver.
+ */
+export declare function resolveWorkersClient<TClient extends object>(runtime: StorageWorkersRuntime, slice: z.ZodType): Promise<TClient>;
+//# sourceMappingURL=workers-port.d.ts.map

package/dist/workers-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers-port.d.ts","sourceRoot":"","sources":["../src/workers-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAgE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpH,qEAAqE;AACrE,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC;AAE1E,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB;;iBAA2C,CAAC;AAEjF,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB;;iBAAqC,CAAC;AAWzE;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,SAAS,MAAM,EAChE,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,CAAC,CAAC,OAAO,GACd,OAAO,CAAC,OAAO,CAAC,CAmBlB"}

package/dist/workers-port.js

@@ -0,0 +1,60 @@
+/**
+ * Storage's view of the Workers runtime client.
+ *
+ * Workers depends on storage, so storage never imports `@vibesdotdev/workers`.
+ * The few places storage hands work to Workers (durable record delivery and
+ * `vibes backup now`) resolve the `runtime/client` kind's `workers` entry on
+ * the runtime they were handed and admit it against the narrow slice they
+ * call, declared by the caller as a schema. The composition (not an import)
+ * decides whether Workers is present.
+ *
+ * - Absent (no `runtime/client` kind, or no `workers` entry): `UNAVAILABLE`
+ *   `storage-workers-client-absent`, with the runtime's own absence as cause.
+ * - Present but not answering the slice: `INTERNAL`
+ *   `storage-workers-client-invalid`.
+ * Any other resolution failure reaches the caller unchanged.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+/** The `runtime/client` id Workers registers its client under. */
+export const WORKERS_CLIENT_ID = 'workers';
+/** Keyed, idempotent enqueue: the slice durable record delivery calls. */
+export const WorkersClaimClientSchema = z.object({ startJobOnce: z.function() });
+/** Dispatch-and-wait: the slice `vibes backup now` calls. */
+export const WorkersRunClientSchema = z.object({ runJob: z.function() });
+function absent(cause) {
+    const error = new CapabilityError('The Workers runtime client is not composed on this runtime.', 'UNAVAILABLE', {
+        reason: 'storage-workers-client-absent',
+        retryable: false,
+        cause
+    });
+    return error;
+}
+/**
+ * Resolve the Workers runtime client on `runtime` as the slice `TClient`
+ * declares, admitted by `slice` before it is returned. The client is returned
+ * as resolved (never a parsed copy), so its methods keep their receiver.
+ */
+export async function resolveWorkersClient(runtime, slice) {
+    if (!runtime.hasKind('runtime/client'))
+        throw absent(undefined);
+    let client;
+    try {
+        client = await runtime.query('runtime/client').withId(WORKERS_CLIENT_ID).resolve();
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        if (failure instanceof Error && CapabilityError.isAbsenceOf(failure, 'runtime/client', WORKERS_CLIENT_ID)) {
+            throw absent(failure);
+        }
+        throw error;
+    }
+    if (!slice.safeParse(client).success) {
+        throw new CapabilityError('The Workers runtime client does not answer the calls storage makes.', 'INTERNAL', {
+            reason: 'storage-workers-client-invalid',
+            retryable: false
+        });
+    }
+    return client;
+}
+//# sourceMappingURL=workers-port.js.map

package/dist/workers-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers-port.js","sourceRoot":"","sources":["../src/workers-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAA2C,MAAM,qBAAqB,CAAC;AAKpH,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C,0EAA0E;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEjF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEzE,SAAS,MAAM,CAAC,KAAwB;IACvC,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,6DAA6D,EAAE,aAAa,EAAE;QAC/G,MAAM,EAAE,+BAA+B;QACvC,SAAS,EAAE,KAAK;QAChB,KAAK;KACL,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,OAA8B,EAC9B,KAAgB;IAEhB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAAE,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAChE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAA6B,gBAAgB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC;IAChH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,OAAO,YAAY,KAAK,IAAI,eAAe,CAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAAE,CAAC;YAC3G,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,eAAe,CAAC,qEAAqE,EAAE,UAAU,EAAE;YAC5G,MAAM,EAAE,gCAAgC;YACxC,SAAS,EAAE,KAAK;SAChB,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC"}