@vibesdotdev/vessel 0.0.0-stage → 1.0.0-rc.3

package/dist/apps/storage.vessel.plugin.d.ts

@@ -0,0 +1,318 @@
+import * as z from 'zod/v4';
+export declare const storageExplorerVesselStateSchema: z.ZodObject<{
+    providerId: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        browse: "browse";
+        connect: "connect";
+    }>>;
+}, z.core.$strict>;
+export declare const storageExplorerVesselAppDescriptor: {
+    identity: {
+        glyph: string;
+        accent: "teal" | "amber" | "azure" | "blue" | "cyan" | "lime" | "rose" | "violet" | "neutral";
+        artworkId?: string | undefined;
+    };
+    id: string;
+    kind: "vessel/app";
+    name: string;
+    description: string;
+    owner: {
+        packageName: string;
+        entrypoint?: string | undefined;
+        specPath?: string | undefined;
+        runtimeKind?: string | undefined;
+        runtimeId?: string | undefined;
+    };
+    category: "agent" | "runtime" | "service" | "tool" | "app" | "feature" | "settings" | "docs" | "audit";
+    launch: {
+        type: "svelte-component";
+        import: string;
+        exportName?: string | undefined;
+    } | {
+        type: "vessel-surface";
+        surfaceId: string;
+        initialState?: Record<string, string | number | boolean | null> | undefined;
+    } | {
+        type: "sveltekit-route";
+        href: string;
+    } | {
+        type: "runtime-client";
+        clientId: string;
+        view: "default" | "inspector";
+    } | {
+        type: "tui-app";
+        route: string;
+    } | {
+        type: "tool";
+        toolId: string;
+    } | {
+        type: "config-manifest";
+        manifestId: string;
+    } | {
+        type: "docs-topic";
+        topicId: string;
+    } | {
+        type: "runtime-descriptor";
+        kind: string;
+        id: string;
+    } | {
+        type: "platform-component";
+        componentId: string;
+        version: string;
+        props: Record<string, unknown>;
+        origin?: string | undefined;
+    } | {
+        type: "applet-artifact";
+        artifactId: string;
+        browserRuntime: boolean;
+        componentRef?: {
+            id: string;
+            version: string;
+            props: Record<string, unknown>;
+            origin?: string | undefined;
+        } | undefined;
+    } | {
+        type: "external-url";
+        href: string;
+    };
+    availability: {
+        status: "unknown" | "unavailable" | "available" | "degraded";
+        summary: string;
+        lastCheckedAt?: string | undefined;
+    };
+    defaultWindow: {
+        width: number;
+        height: number;
+        x: number;
+        y: number;
+        minWidth: number;
+        minHeight: number;
+    };
+    tags: string[];
+    workLocations: ("browser" | "cloud" | "computer" | "vessel")[];
+    readinessAreaIds: string[];
+    setupStepIds: string[];
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+    ports?: {
+        id: string;
+        label: string;
+        direction: "output" | "input";
+        schema: {
+            mediaType: string;
+            shape: "any" | "event" | "stream" | "json" | "text" | "binary";
+            schemaId?: string | undefined;
+        };
+        multiple: boolean;
+        required: boolean;
+    }[] | undefined;
+};
+export declare const storageExplorerVesselReadinessDescriptor: {
+    id: string;
+    kind: "vessel/readiness-area";
+    label: string;
+    userPromise: string;
+    status: "unknown" | "ready" | "needs-setup" | "planned" | "blocked";
+    summary: string;
+    owner: {
+        packageName: string;
+        entrypoint?: string | undefined;
+        specPath?: string | undefined;
+        runtimeKind?: string | undefined;
+        runtimeId?: string | undefined;
+    };
+    targetKinds: string[];
+    evidence: ({
+        type: "runtime-query";
+        kind: string;
+        resultSummary: string;
+        id?: string | undefined;
+    } | {
+        type: "command";
+        cwd: string;
+        command: string;
+        exitCode: number;
+        summary: string;
+    } | {
+        type: "http";
+        method: string;
+        url: string;
+        status: number;
+        summary: string;
+    } | {
+        type: "screenshot";
+        path: string;
+        summary: string;
+        viewport?: string | undefined;
+    } | {
+        type: "source";
+        path: string;
+        summary: string;
+        line?: number | undefined;
+    } | {
+        type: "spec";
+        path: string;
+        summary: string;
+        heading?: string | undefined;
+    })[];
+    linkedFindingIds: string[];
+    upstreamWorkItemIds: string[];
+    proofGate: string;
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+    nextAction?: {
+        label: string;
+        href?: string | undefined;
+        command?: string | undefined;
+    } | undefined;
+};
+export declare const storageExplorerVesselSetupDescriptor: {
+    id: string;
+    kind: "vessel/setup-step";
+    areaId: string;
+    order: number;
+    label: string;
+    userAction: string;
+    userResult: string;
+    place: "browser" | "cloud" | "vibes" | "computer" | "vessel";
+    status: "unknown" | "ready" | "needs-setup" | "planned" | "blocked";
+    owner: {
+        packageName: string;
+        entrypoint?: string | undefined;
+        specPath?: string | undefined;
+        runtimeKind?: string | undefined;
+        runtimeId?: string | undefined;
+    };
+    evidence: ({
+        type: "runtime-query";
+        kind: string;
+        resultSummary: string;
+        id?: string | undefined;
+    } | {
+        type: "command";
+        cwd: string;
+        command: string;
+        exitCode: number;
+        summary: string;
+    } | {
+        type: "http";
+        method: string;
+        url: string;
+        status: number;
+        summary: string;
+    } | {
+        type: "screenshot";
+        path: string;
+        summary: string;
+        viewport?: string | undefined;
+    } | {
+        type: "source";
+        path: string;
+        summary: string;
+        line?: number | undefined;
+    } | {
+        type: "spec";
+        path: string;
+        summary: string;
+        heading?: string | undefined;
+    })[];
+    upstreamWorkItemIds: string[];
+    proofGate: string;
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+    nextAction?: {
+        label: string;
+        href?: string | undefined;
+        command?: string | undefined;
+    } | undefined;
+    falsifier?: string | undefined;
+};
+export declare const storageExplorerVesselSurfaceDescriptor: {
+    kind: "vessel/surface";
+    id: string;
+    name: string;
+    description: string;
+    label: string;
+    surfaceKind: string;
+    owner: {
+        packageName: string;
+    };
+    contract: {
+        apiVersion: string;
+        stateSchemaId: string;
+        stateSchemaVersion: number;
+        stateSchema: z.ZodObject<{
+            providerId: z.ZodOptional<z.ZodString>;
+            mode: z.ZodOptional<z.ZodEnum<{
+                browse: "browse";
+                connect: "connect";
+            }>>;
+        }, z.core.$strict>;
+    };
+    activation: string;
+    execution: string;
+    requiredCapabilities: {
+        id: string;
+        selectorId: string;
+        reason: string;
+    }[];
+    optionalCapabilities: {
+        id: string;
+        reason: string;
+    }[];
+    primaryAudience: string;
+    secondaryAudiences: string[];
+    technicalLanguagePolicy: string;
+    promotionGate: string;
+};
+export declare const storageSvelteVesselPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default storageSvelteVesselPlugin;
+//# sourceMappingURL=storage.vessel.plugin.d.ts.map

package/dist/apps/storage.vessel.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.vessel.plugin.d.ts","sourceRoot":"","sources":["../../src/apps/storage.vessel.plugin.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAc5B,eAAO,MAAM,gCAAgC;;;;;;kBAMnC,CAAC;AAEX,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB7C,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAanD,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAe/C,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCjD,CAAC;AAEH,eAAO,MAAM,yBAAyB,6CAqBpC,CAAC;AAEH,eAAe,yBAAyB,CAAC"}

package/dist/apps/storage.vessel.plugin.js

@@ -0,0 +1,132 @@
+/**
+ * The Storage app on Vessel hosts (`hub.storage`).
+ *
+ * Vessel declares the app, its readiness area, setup step and surface; the
+ * surface component is Storage's own explorer (`@vibesdotdev/storage/svelte`),
+ * loaded in browsers only. This plugin lives with Vessel because Vessel
+ * depends on Storage, never the reverse. Its plugin id is unchanged, so
+ * compositions and readiness owners that name it keep resolving.
+ */
+import { createRuntimeAsset, createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { vesselAppDescriptorSchema, vesselReadinessAreaSchema, vesselSetupStepSchema } from "../schemas.js";
+const storageVesselOwner = {
+    packageName: '@vibesdotdev/storage/svelte',
+    entrypoint: './StorageExplorer.svelte',
+    runtimeKind: 'storage/explorer',
+    runtimeId: 'storage.explorer'
+};
+export const storageExplorerVesselStateSchema = z
+    .object({
+    providerId: z.string().min(1).optional(),
+    /** Durable presentation state; never persist an imperative "open dialog" command. */
+    mode: z.enum(['browse', 'connect']).optional()
+})
+    .strict();
+export const storageExplorerVesselAppDescriptor = vesselAppDescriptorSchema.parse({
+    kind: 'vessel/app',
+    id: 'hub.storage',
+    name: 'Storage',
+    description: 'Browse Vibes Storage and drives from connected providers.',
+    owner: storageVesselOwner,
+    identity: { glyph: 'lucide:hard-drive', accent: 'amber' },
+    category: 'feature',
+    launch: {
+        type: 'vessel-surface',
+        surfaceId: 'storage.explorer',
+        initialState: {}
+    },
+    availability: {
+        status: 'unknown',
+        summary: 'Storage checks signed-in drives when opened.'
+    },
+    defaultWindow: { x: 140, y: 92, width: 1040, height: 680, minWidth: 720, minHeight: 480 },
+    tags: ['storage', 'drives', 'files', 'connect'],
+    workLocations: ['browser', 'cloud', 'vessel'],
+    readinessAreaIds: ['readiness.storage'],
+    setupStepIds: ['setup.storage.browser']
+});
+export const storageExplorerVesselReadinessDescriptor = vesselReadinessAreaSchema.parse({
+    kind: 'vessel/readiness-area',
+    id: 'readiness.storage',
+    label: 'Storage',
+    userPromise: 'Browse connected storage drives',
+    status: 'unknown',
+    summary: 'Storage readiness follows live signed-in drive enumeration.',
+    owner: storageVesselOwner,
+    targetKinds: ['storage/explorer'],
+    evidence: [],
+    linkedFindingIds: [],
+    upstreamWorkItemIds: [],
+    proofGate: 'A signed-in host enumerates real storage drives through storage/explorer.'
+});
+export const storageExplorerVesselSetupDescriptor = vesselSetupStepSchema.parse({
+    kind: 'vessel/setup-step',
+    id: 'setup.storage.browser',
+    areaId: 'readiness.storage',
+    order: 51,
+    label: 'Open Storage',
+    userAction: 'Open Storage to browse or connect a drive.',
+    userResult: 'Storage shows the drives available to the signed-in account.',
+    place: 'vessel',
+    status: 'unknown',
+    owner: storageVesselOwner,
+    evidence: [],
+    upstreamWorkItemIds: [],
+    proofGate: 'The Storage owner surface lists real account-scoped drives or an exact failure.',
+    falsifier: 'The surface launches without storage/explorer or invents connected drives.'
+});
+export const storageExplorerVesselSurfaceDescriptor = createRuntimeAsset({
+    kind: 'vessel/surface',
+    id: 'storage.explorer',
+    name: 'Storage explorer',
+    description: 'Browse account-scoped storage drives through the Platform runtime client.',
+    label: 'Storage explorer',
+    surfaceKind: 'component',
+    owner: { packageName: '@vibesdotdev/storage/svelte' },
+    contract: {
+        apiVersion: '1.0.0',
+        stateSchemaId: 'storage.explorer.state',
+        stateSchemaVersion: 1,
+        stateSchema: storageExplorerVesselStateSchema
+    },
+    activation: 'on-open',
+    execution: 'host-trusted',
+    requiredCapabilities: [
+        {
+            id: 'storage/explorer',
+            selectorId: 'storage.explorer',
+            reason: 'Enumerate and browse storage authorized for the signed-in principal without projecting backend configuration.'
+        }
+    ],
+    optionalCapabilities: [
+        {
+            id: 'storage/provider-connect',
+            reason: 'Offer provider connection when the host supplies connectable scopes.'
+        }
+    ],
+    primaryAudience: 'workspace-user',
+    secondaryAudiences: ['host-integrator'],
+    technicalLanguagePolicy: 'hide',
+    promotionGate: 'Real signed-in browser proof enumerates a Vibes Storage drive and connect actions.'
+});
+export const storageSvelteVesselPlugin = createRuntimePlugin({
+    id: '@vibesdotdev/storage/svelte/vessel',
+    name: 'Storage Svelte Vessel Surface',
+    description: 'Owner-declared account storage contribution for Vessel hosts.',
+    dependencies: ['vessel'],
+    descriptors: [
+        storageExplorerVesselAppDescriptor,
+        storageExplorerVesselSurfaceDescriptor,
+        storageExplorerVesselReadinessDescriptor,
+        storageExplorerVesselSetupDescriptor
+    ],
+    loaders: [
+        loader(storageExplorerVesselSurfaceDescriptor.id, { kind: 'vessel/surface', scope: 'browser' }, async () => {
+            const module = await import('@vibesdotdev/storage/svelte/StorageExplorer.svelte');
+            return { impl: module.default };
+        })
+    ]
+});
+export default storageSvelteVesselPlugin;
+//# sourceMappingURL=storage.vessel.plugin.js.map

package/dist/apps/storage.vessel.plugin.js.map

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