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

package/dist/workspace/vessel-platform.descriptors.d.ts

@@ -0,0 +1,809 @@
+/**
+ * Platform deep-link vessel/app descriptors — desktop view into vibes cloud apps.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+export declare const vesselPlatformAppDescriptors: {
+    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" | "service" | "tool" | "runtime" | "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 vesselPlatformReadinessDescriptors: {
+    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 vesselPlatformSetupDescriptors: {
+    id: string;
+    kind: "vessel/setup-step";
+    areaId: string;
+    order: number;
+    label: string;
+    userAction: string;
+    userResult: string;
+    place: "browser" | "vibes" | "cloud" | "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 vesselPlatformDescriptors: ({
+    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" | "service" | "tool" | "runtime" | "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;
+} | {
+    id: string;
+    kind: "vessel/setup-step";
+    areaId: string;
+    order: number;
+    label: string;
+    userAction: string;
+    userResult: string;
+    place: "browser" | "vibes" | "cloud" | "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;
+} | {
+    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;
+})[];
+/** Resolve all targets before publishing any runtime-specific app descriptors. */
+export declare function resolveVesselPlatformDescriptors(runtime: RuntimeRef): Promise<({
+    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" | "service" | "tool" | "runtime" | "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;
+} | {
+    id: string;
+    kind: "vessel/setup-step";
+    areaId: string;
+    order: number;
+    label: string;
+    userAction: string;
+    userResult: string;
+    place: "browser" | "vibes" | "cloud" | "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;
+} | {
+    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;
+})[]>;
+//# sourceMappingURL=vessel-platform.descriptors.d.ts.map