@vibesdotdev/platform 0.0.0-stage → 1.0.0-rc.2

package/dist/components/compiler/tools.plugin.d.ts

@@ -0,0 +1,4 @@
+/** Composition for hosts that expose compilation through their Tools pipeline. */
+declare const compilerToolsPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default compilerToolsPlugin;
+//# sourceMappingURL=tools.plugin.d.ts.map

package/dist/components/compiler/tools.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.plugin.d.ts","sourceRoot":"","sources":["../../../src/components/compiler/tools.plugin.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,QAAA,MAAM,mBAAmB,6CAOvB,CAAC;AAEH,eAAe,mBAAmB,CAAC"}

package/dist/components/compiler/tools.plugin.js

@@ -0,0 +1,12 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import descriptor from "./compiler.tool.descriptor.js";
+/** Composition for hosts that expose compilation through their Tools pipeline. */
+const compilerToolsPlugin = createRuntimePlugin({
+    id: 'platform-components-compiler-tools',
+    name: 'Component compiler tools',
+    dependencies: ['tools'],
+    descriptors: [descriptor],
+    loaders: [loader(descriptor.id, { kind: 'tools/tool', scope: 'consumer' }, () => import("./compiler.tool.impl.js"))]
+});
+export default compilerToolsPlugin;
+//# sourceMappingURL=tools.plugin.js.map

package/dist/components/compiler/tools.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.plugin.js","sourceRoot":"","sources":["../../../src/components/compiler/tools.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,UAAU,MAAM,+BAA+B,CAAC;AAEvD,kFAAkF;AAClF,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;IAC/C,EAAE,EAAE,oCAAoC;IACxC,IAAI,EAAE,0BAA0B;IAChC,YAAY,EAAE,CAAC,OAAO,CAAC;IACvB,WAAW,EAAE,CAAC,UAAU,CAAC;IACzB,OAAO,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,EACxE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC;CAC1C,CAAC,CAAC;AAEH,eAAe,mBAAmB,CAAC"}

package/dist/config/load.d.ts

@@ -0,0 +1,6 @@
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import { type PlatformConfig } from './platform.config.descriptor.ts';
+export type PlatformConfigRuntime = RuntimeRef;
+export declare function loadPlatformConfig(runtime: PlatformConfigRuntime): Promise<PlatformConfig>;
+export declare function resolvePlatformCloudLoopbackOrigin(runtime: PlatformConfigRuntime): Promise<string | null>;
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAGN,KAAK,cAAc,EACnB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAE/C,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAGhG;AAED,wBAAsB,kCAAkC,CACvD,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB"}

package/dist/config/load.js

@@ -0,0 +1,14 @@
+import { ConfigManifest } from '@vibesdotdev/config/manifest/config-manifest';
+import { PLATFORM_CONFIG_MANIFEST_ID, PlatformConfigSchema } from "./platform.config.descriptor.js";
+export async function loadPlatformConfig(runtime) {
+    if (!ConfigManifest.isRegistered(runtime, PLATFORM_CONFIG_MANIFEST_ID))
+        return PlatformConfigSchema.parse({});
+    return ConfigManifest.forRuntime(runtime, PLATFORM_CONFIG_MANIFEST_ID).load();
+}
+export async function resolvePlatformCloudLoopbackOrigin(runtime) {
+    const fromConfig = (await loadPlatformConfig(runtime)).vibesInternalPlatformOrigin;
+    if (!fromConfig || fromConfig.trim().length === 0)
+        return null;
+    return fromConfig.replace(/\/$/, '');
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAE9E,OAAO,EACN,2BAA2B,EAC3B,oBAAoB,EAEpB,MAAM,iCAAiC,CAAC;AAIzC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA8B;IACtE,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,OAAO,EAAE,2BAA2B,CAAC;QAAE,OAAO,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9G,OAAO,cAAc,CAAC,UAAU,CAAiB,OAAO,EAAE,2BAA2B,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACvD,OAA8B;IAE9B,MAAM,UAAU,GAAG,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC;IACnF,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/config/platform.config.descriptor.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Platform cloud loopback — config/manifest.
+ *
+ * `VIBES_INTERNAL_PLATFORM_ORIGIN` is the in-process cloud same-origin
+ * override. `VIBES_PLATFORM_API_URL` / `PUBLIC_VIBES_PLATFORM_ORIGIN` had no
+ * remaining callers (consumer origin is the service catalog).
+ */
+import * as z from 'zod/v4';
+export declare const PlatformConfigSchema: z.ZodObject<{
+    fleetInstallUrl: z.ZodDefault<z.ZodURL>;
+    fleetRegistryUrl: z.ZodDefault<z.ZodURL>;
+    vibesInternalPlatformOrigin: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+}, z.core.$strip>;
+export type PlatformConfig = z.infer<typeof PlatformConfigSchema>;
+export declare const PLATFORM_CONFIG_MANIFEST_ID = "platform";
+declare const descriptor: {
+    kind: "config/manifest";
+    id: string;
+    name: string;
+    namespace: string;
+    description: string;
+    schema: z.ZodObject<{
+        fleetInstallUrl: z.ZodDefault<z.ZodURL>;
+        fleetRegistryUrl: z.ZodDefault<z.ZodURL>;
+        vibesInternalPlatformOrigin: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    }, z.core.$strip>;
+    scope: "global";
+    tier: "system";
+    storedLayer: "none";
+    allowedAdapters: string[];
+    fields: {
+        fleetInstallUrl: {
+            ui: {
+                label: string;
+                component: "input";
+            };
+        };
+        fleetRegistryUrl: {
+            ui: {
+                label: string;
+                component: "input";
+            };
+        };
+        vibesInternalPlatformOrigin: {
+            ui: {
+                label: string;
+                component: "input";
+            };
+        };
+    };
+    customTables: false;
+    version: number;
+    internal: false;
+};
+export default descriptor;
+//# sourceMappingURL=platform.config.descriptor.d.ts.map

package/dist/config/platform.config.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.config.descriptor.d.ts","sourceRoot":"","sources":["../../src/config/platform.config.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,oBAAoB;;;;iBAO/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAEtD,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBoB,CAAC;AAErC,eAAe,UAAU,CAAC"}

package/dist/config/platform.config.descriptor.js

@@ -0,0 +1,39 @@
+/**
+ * Platform cloud loopback — config/manifest.
+ *
+ * `VIBES_INTERNAL_PLATFORM_ORIGIN` is the in-process cloud same-origin
+ * override. `VIBES_PLATFORM_API_URL` / `PUBLIC_VIBES_PLATFORM_ORIGIN` had no
+ * remaining callers (consumer origin is the service catalog).
+ */
+import * as z from 'zod/v4';
+export const PlatformConfigSchema = z.object({
+    fleetInstallUrl: z.url().default('https://cli.vibes.dev/install.sh'),
+    fleetRegistryUrl: z.url().default('https://packages.vibes.dev/'),
+    vibesInternalPlatformOrigin: z
+        .string()
+        .optional()
+        .transform((v) => (v === undefined || v.trim() === '' ? undefined : v))
+});
+export const PLATFORM_CONFIG_MANIFEST_ID = 'platform';
+const descriptor = {
+    kind: 'config/manifest',
+    id: PLATFORM_CONFIG_MANIFEST_ID,
+    name: 'Platform',
+    namespace: 'platform',
+    description: 'Cloud-scope same-origin loopback for in-process platform-web',
+    schema: PlatformConfigSchema,
+    scope: 'global',
+    tier: 'system',
+    storedLayer: 'none',
+    allowedAdapters: ['storage.json', 'storage.localdb'],
+    fields: {
+        fleetInstallUrl: { ui: { label: 'Fleet CLI installer', component: 'input' } },
+        fleetRegistryUrl: { ui: { label: 'Fleet package registry', component: 'input' } },
+        vibesInternalPlatformOrigin: { ui: { label: 'Internal platform origin', component: 'input' } }
+    },
+    customTables: false,
+    version: 1,
+    internal: false
+};
+export default descriptor;
+//# sourceMappingURL=platform.config.descriptor.js.map

package/dist/config/platform.config.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.config.descriptor.js","sourceRoot":"","sources":["../../src/config/platform.config.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,kCAAkC,CAAC;IACpE,gBAAgB,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC;IAChE,2BAA2B,EAAE,CAAC;SAC5B,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACxE,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC;AAEtD,MAAM,UAAU,GAAG;IAClB,IAAI,EAAE,iBAAiB;IACvB,EAAE,EAAE,2BAA2B;IAC/B,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,UAAU;IACrB,WAAW,EAAE,8DAA8D;IAC3E,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,MAAM;IACnB,eAAe,EAAE,CAAC,cAAc,EAAE,iBAAiB,CAAC;IACpD,MAAM,EAAE;QACP,eAAe,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;QAC7E,gBAAgB,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;QACjF,2BAA2B,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;KAC9F;IACD,YAAY,EAAE,KAAK;IACnB,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,KAAK;CACoB,CAAC;AAErC,eAAe,UAAU,CAAC"}

package/dist/docs/errors.billing.insufficient-credits.docs.descriptor.d.ts

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

package/dist/docs/errors.billing.insufficient-credits.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.billing.insufficient-credits.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/errors.billing.insufficient-credits.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAsCvE,QAAA,MAAM,UAAU,EAAE,mBAmBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/errors.billing.insufficient-credits.docs.descriptor.js

@@ -0,0 +1,57 @@
+const markdown = `---
+title: Insufficient credits
+summary: INSUFFICIENT_CREDITS — your credit balance is too low for this action
+tags: [errors, billing, credits]
+parent: errors
+surfaces: [web, in-app]
+---
+
+# Insufficient credits
+
+\`\`\`
+INSUFFICIENT_CREDITS
+\`\`\`
+
+The action (e.g. an AI generation or a storage upload) was declined because your
+account doesn't have enough credits to cover its cost.
+
+## What it means
+
+Metered features deduct credits per use. When the required amount exceeds your
+current balance, the request is rejected with this code before any charge is
+made — so you are never partially billed for a declined action.
+
+## How to resolve it
+
+- **Add credits.** Go to Account → Billing → Credits and top up. Most surfaces
+  also offer an inline "Add credits" dialog right where the error appears.
+- **Upgrade your plan.** Higher tiers include a larger monthly credit allowance.
+- **Lower the cost.** For generation, fewer images / smaller dimensions / fewer
+  steps cost less per run.
+
+The code is part of the platform's stable error contract, exposed as
+\`subject: { kind: 'error', id: 'INSUFFICIENT_CREDITS' }\` so in-app help can
+deep-link straight here.
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'errors.billing.insufficient-credits',
+    title: 'Insufficient credits',
+    summary: 'INSUFFICIENT_CREDITS — your credit balance is too low for this action',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'errors',
+    order: 4,
+    tags: ['errors', 'billing', 'credits'],
+    surfaces: ['web', 'in-app'],
+    subject: {
+        kind: 'error',
+        id: 'INSUFFICIENT_CREDITS'
+    },
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=errors.billing.insufficient-credits.docs.descriptor.js.map

package/dist/docs/errors.billing.insufficient-credits.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.billing.insufficient-credits.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/errors.billing.insufficient-credits.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkChB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,qCAAqC;IACzC,KAAK,EAAE,sBAAsB;IAC7B,OAAO,EAAE,uEAAuE;IAChF,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;IACtC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE;QACR,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,sBAAsB;KAC1B;IACD,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/docs/errors.docs.descriptor.js

@@ -0,0 +1,64 @@
+const markdown = `---
+title: Error codes
+summary: What the stable error codes mean and how to resolve them
+tags: [errors, reference]
+surfaces: [web, in-app]
+---
+
+# Error codes
+
+When something goes wrong, the platform returns a **stable, machine-readable
+error code** alongside a human message, in a predictable JSON envelope:
+
+:::usage{language="json"}
+{
+  "error": {
+    "code": "STORAGE_QUOTA_EXCEEDED",
+    "message": "Quota exceeded: requested 873.84 KB, limit 0.00 B"
+  }
+}
+:::
+
+The \`code\` never changes for a given failure mode, so:
+
+- **Apps** can switch on it to show the right recovery action (e.g. open the
+  credits dialog for \`INSUFFICIENT_CREDITS\`).
+- **You** can search these docs for the exact code you saw — each code links to
+  a page explaining what it means and how to fix it.
+- **Support** can reference it unambiguously.
+
+If a UI shows you a code, look it up here or follow its **Get help** link.
+
+## Storage
+
+:::descriptor{kind="docs/topic" id="errors.storage.quota-exceeded"}
+:::
+
+:::descriptor{kind="docs/topic" id="errors.storage.access-denied"}
+:::
+
+:::descriptor{kind="docs/topic" id="errors.storage.provider-not-found"}
+:::
+
+## Billing
+
+:::descriptor{kind="docs/topic" id="errors.billing.insufficient-credits"}
+:::
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'errors',
+    title: 'Error codes',
+    summary: 'What the stable error codes mean and how to resolve them',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    order: 90,
+    tags: ['errors', 'reference'],
+    surfaces: ['web', 'in-app'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=errors.docs.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/errors.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8ChB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE,0DAA0D;IACnE,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KAChB;IACD,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/errors.storage.access-denied.docs.descriptor.d.ts

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

package/dist/docs/errors.storage.access-denied.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.storage.access-denied.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/errors.storage.access-denied.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAyCvE,QAAA,MAAM,UAAU,EAAE,mBAoBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/errors.storage.access-denied.docs.descriptor.js

@@ -0,0 +1,60 @@
+const markdown = `---
+title: Storage access denied
+summary: STORAGE_ACCESS_DENIED — you don't have permission to write to the chosen storage destination
+tags: [errors, storage, permissions]
+parent: errors
+surfaces: [web, in-app]
+---
+
+# Storage access denied
+
+\`\`\`
+STORAGE_ACCESS_DENIED
+\`\`\`
+
+The upload (including images saved by AI generation) was rejected because your
+account doesn't have permission to write to the selected storage destination.
+
+## What it means
+
+Each upload resolves a storage provider — the default vibes storage, or a
+connected destination you configured (e.g. your own S3/R2 bucket). This error
+means the resolved destination exists but the request isn't authorized to write
+to it: the provider belongs to another user/organization, the credentials were
+revoked, or the destination isn't shared with your current organization.
+
+## How to resolve it
+
+- **Pick a different destination.** On the generation form, switch the storage
+  destination back to the default vibes storage, or to one you own.
+- **Re-check the connected provider.** In Account → Storage, confirm the provider
+  is active and its credentials are still valid; re-authorize if needed.
+- **Switch organization.** If the destination belongs to a different org, switch
+  to that organization before generating.
+
+The code is part of the platform's stable error contract, exposed as
+\`subject: { kind: 'error', id: 'STORAGE_ACCESS_DENIED' }\` so in-app help can
+deep-link straight here.
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'errors.storage.access-denied',
+    title: 'Storage access denied',
+    summary: "STORAGE_ACCESS_DENIED — you don't have permission to write to the chosen storage destination",
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'errors',
+    order: 2,
+    tags: ['errors', 'storage', 'permissions'],
+    surfaces: ['web', 'in-app'],
+    subject: {
+        kind: 'error',
+        id: 'STORAGE_ACCESS_DENIED'
+    },
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=errors.storage.access-denied.docs.descriptor.js.map

package/dist/docs/errors.storage.access-denied.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.storage.access-denied.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/errors.storage.access-denied.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqChB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,8BAA8B;IAClC,KAAK,EAAE,uBAAuB;IAC9B,OAAO,EACN,8FAA8F;IAC/F,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE;QACR,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,uBAAuB;KAC3B;IACD,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/errors.storage.provider-not-found.docs.descriptor.d.ts

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

package/dist/docs/errors.storage.provider-not-found.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.storage.provider-not-found.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/errors.storage.provider-not-found.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAyCvE,QAAA,MAAM,UAAU,EAAE,mBAmBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/errors.storage.provider-not-found.docs.descriptor.js

@@ -0,0 +1,60 @@
+const markdown = `---
+title: Storage provider not found
+summary: STORAGE_PROVIDER_NOT_FOUND — the selected storage destination no longer exists
+tags: [errors, storage]
+parent: errors
+surfaces: [web, in-app]
+---
+
+# Storage provider not found
+
+\`\`\`
+STORAGE_PROVIDER_NOT_FOUND
+\`\`\`
+
+The upload couldn't complete because the storage destination it tried to use no
+longer exists.
+
+## What it means
+
+The request referenced a specific storage provider id, but no active provider
+with that id is registered for your account or organization. This usually
+happens when a connected destination was deleted or deactivated after it was
+selected, or when a stale provider id is sent from an older session.
+
+## How to resolve it
+
+- **Re-select the destination.** On the generation form, open the storage
+  destination picker and choose an available destination (the default vibes
+  storage always works).
+- **Reconnect the provider.** If you expected a connected destination to be
+  there, re-add it in Account → Storage.
+- **Refresh the page.** A stale client may be holding a deleted provider id;
+  reload to pick up the current list.
+
+The code is part of the platform's stable error contract, exposed as
+\`subject: { kind: 'error', id: 'STORAGE_PROVIDER_NOT_FOUND' }\` so in-app help
+can deep-link straight here.
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'errors.storage.provider-not-found',
+    title: 'Storage provider not found',
+    summary: 'STORAGE_PROVIDER_NOT_FOUND — the selected storage destination no longer exists',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'errors',
+    order: 3,
+    tags: ['errors', 'storage'],
+    surfaces: ['web', 'in-app'],
+    subject: {
+        kind: 'error',
+        id: 'STORAGE_PROVIDER_NOT_FOUND'
+    },
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=errors.storage.provider-not-found.docs.descriptor.js.map

package/dist/docs/errors.storage.provider-not-found.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.storage.provider-not-found.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/errors.storage.provider-not-found.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqChB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,mCAAmC;IACvC,KAAK,EAAE,4BAA4B;IACnC,OAAO,EAAE,gFAAgF;IACzF,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE;QACR,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,4BAA4B;KAChC;IACD,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/errors.storage.quota-exceeded.docs.descriptor.d.ts

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

package/dist/docs/errors.storage.quota-exceeded.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.storage.quota-exceeded.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/errors.storage.quota-exceeded.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAuDvE,QAAA,MAAM,UAAU,EAAE,mBAoBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/errors.storage.quota-exceeded.docs.descriptor.js

@@ -0,0 +1,74 @@
+const markdown = `---
+title: Storage quota exceeded
+summary: STORAGE_QUOTA_EXCEEDED — an upload was larger than the space available to your account
+tags: [errors, storage, quota, billing]
+parent: errors
+surfaces: [web, in-app]
+---
+
+# Storage quota exceeded
+
+\`\`\`
+STORAGE_QUOTA_EXCEEDED
+\`\`\`
+
+An upload — including images and other files saved by AI generation — was
+rejected because it would exceed the storage available to your account.
+
+## What it means
+
+Every upload is checked against your plan's storage allowance before the file
+is written. When the requested size is larger than the remaining allowance, the
+platform returns this code with a message like:
+
+:::usage{language="json"}
+{
+  "error": {
+    "code": "STORAGE_QUOTA_EXCEEDED",
+    "message": "Quota exceeded: requested 2.4 MB, limit 100.00 MB"
+  }
+}
+:::
+
+## How to resolve it
+
+- **Free up space.** Delete media or files you no longer need, then retry.
+- **Upgrade your plan.** Higher tiers include more storage. Manage your plan in
+  Account → Billing.
+- **Pick a different destination.** If you generate into a connected provider
+  (e.g. your own bucket), switch the storage destination on the generation form.
+
+## For developers
+
+> If you see a \`limit\` of \`0 B\` here, that's a *degraded billing/entitlement
+> service*, not a real zero allowance. The storage upload path now fails **open**
+> in that case — a null/zero limit is treated as "unknown", not "zero bytes" —
+> so a transient billing outage no longer blocks uploads. A genuine
+> \`STORAGE_QUOTA_EXCEEDED\` only fires against a real positive limit.
+
+The code is part of the platform's stable error contract and is also exposed as
+\`subject: { kind: 'error', id: 'STORAGE_QUOTA_EXCEEDED' }\` so in-app help
+surfaces can deep-link straight here.
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'errors.storage.quota-exceeded',
+    title: 'Storage quota exceeded',
+    summary: 'STORAGE_QUOTA_EXCEEDED — an upload was larger than the space available to your account',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'errors',
+    order: 1,
+    tags: ['errors', 'storage', 'quota', 'billing'],
+    surfaces: ['web', 'in-app'],
+    subject: {
+        kind: 'error',
+        id: 'STORAGE_QUOTA_EXCEEDED'
+    },
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=errors.storage.quota-exceeded.docs.descriptor.js.map

package/dist/docs/errors.storage.quota-exceeded.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.storage.quota-exceeded.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/errors.storage.quota-exceeded.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDhB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,+BAA+B;IACnC,KAAK,EAAE,wBAAwB;IAC/B,OAAO,EACN,wFAAwF;IACzF,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE;QACR,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,wBAAwB;KAC5B;IACD,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/platform.config.docs.descriptor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Descriptor for platform.config
+ */
+declare const descriptor: {
+    kind: "docs/topic";
+    id: string;
+    title: string;
+    summary: string;
+    body: {
+        type: "markdown";
+        sourceType: "raw";
+        source: string;
+    };
+    parent: string;
+    order: number;
+    tags: string[];
+    surfaces: readonly ["cli", "web", "in-app"];
+    hardware: readonly ["consumer"];
+    enabled: boolean;
+};
+export default descriptor;
+//# sourceMappingURL=platform.config.docs.descriptor.d.ts.map

package/dist/docs/platform.config.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.config.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/platform.config.docs.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+DH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;CAgBf,CAAC;AAEF,eAAe,UAAU,CAAC"}