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

package/dist/shell/launch-resolution.js

@@ -0,0 +1,163 @@
+/**
+ * Launch-target resolution and readiness projection for Vessel apps.
+ *
+ * Pure functions over vessel descriptors — no runtime I/O, no Svelte.
+ */
+function readinessRank(status) {
+    switch (status) {
+        case 'ready':
+            return 0;
+        case 'needs-setup':
+            return 2;
+        case 'planned':
+            return 3;
+        case 'blocked':
+            return 4;
+        default:
+            return 1;
+    }
+}
+function availabilityFromReadiness(areas) {
+    if (areas.length === 0) {
+        return { status: 'available', summary: 'No readiness gates linked.', blockingAreaIds: [] };
+    }
+    const worst = [...areas].sort((a, b) => readinessRank(b.status) - readinessRank(a.status))[0];
+    const blocking = areas.filter((area) => area.status !== 'ready' && area.status !== 'unknown');
+    if (worst.status === 'ready') {
+        return {
+            status: 'available',
+            summary: areas.map((a) => a.summary).join(' ') || 'Ready.',
+            blockingAreaIds: []
+        };
+    }
+    if (worst.status === 'blocked') {
+        return {
+            status: 'unavailable',
+            summary: worst.summary,
+            blockingAreaIds: blocking.map((a) => a.id)
+        };
+    }
+    if (worst.status === 'planned') {
+        return {
+            status: 'unavailable',
+            summary: worst.summary,
+            blockingAreaIds: blocking.map((a) => a.id)
+        };
+    }
+    if (worst.status === 'needs-setup') {
+        return {
+            status: 'degraded',
+            summary: worst.summary,
+            blockingAreaIds: blocking.map((a) => a.id)
+        };
+    }
+    return {
+        status: 'unknown',
+        summary: worst.summary,
+        blockingAreaIds: []
+    };
+}
+function mergeStatus(appStatus, readinessStatus) {
+    const rank = {
+        available: 0,
+        unknown: 1,
+        degraded: 2,
+        unavailable: 3
+    };
+    return rank[appStatus] >= rank[readinessStatus] ? appStatus : readinessStatus;
+}
+/**
+ * Resolve whether a vessel/app can open content vs readiness panel.
+ */
+export function resolveAppLaunch(app, readinessAreas = [], setupSteps = [], options = {}) {
+    const respectReadiness = options.respectReadiness !== false;
+    const linkedAreas = readinessAreas.filter((area) => app.readinessAreaIds.includes(area.id));
+    const linkedSteps = setupSteps.filter((step) => app.setupStepIds.includes(step.id));
+    const pendingSetupStepIds = linkedSteps
+        .filter((step) => step.status !== 'ready')
+        .map((step) => step.id);
+    const fromApp = {
+        status: app.availability.status,
+        summary: app.availability.summary
+    };
+    const fromReadiness = respectReadiness
+        ? availabilityFromReadiness(linkedAreas)
+        : { status: 'available', summary: '', blockingAreaIds: [] };
+    const status = mergeStatus(fromApp.status, fromReadiness.status);
+    const summaryParts = [fromApp.summary, fromReadiness.summary].filter(Boolean);
+    const summary = summaryParts.join(' — ') || 'Not checked';
+    const canOpen = status === 'available' || status === 'degraded' || status === 'unknown';
+    // Unavailable always shows the readiness panel; degraded with pending setup
+    // also surfaces the panel so users get an honest path (not a blank window).
+    const showUnavailablePanel = status === 'unavailable' || (status === 'degraded' && pendingSetupStepIds.length > 0);
+    return {
+        appId: app.id,
+        appName: app.name,
+        launch: app.launch,
+        canOpen,
+        status,
+        summary,
+        blockingAreaIds: fromReadiness.blockingAreaIds,
+        pendingSetupStepIds,
+        showUnavailablePanel
+    };
+}
+/**
+ * Human-readable label for a launch target (launcher / inspector).
+ */
+export function describeLaunchTarget(launch) {
+    switch (launch.type) {
+        case 'svelte-component':
+            return `component:${launch.import}${launch.exportName ? `#${launch.exportName}` : ''}`;
+        case 'vessel-surface':
+            return `surface:${launch.surfaceId}`;
+        case 'sveltekit-route':
+            return `route:${launch.href}`;
+        case 'runtime-client':
+            return `client:${launch.clientId}/${launch.view}`;
+        case 'tui-app':
+            return `tui:${launch.route}`;
+        case 'tool':
+            return `tool:${launch.toolId}`;
+        case 'config-manifest':
+            return `config:${launch.manifestId}`;
+        case 'docs-topic':
+            return `docs:${launch.topicId}`;
+        case 'runtime-descriptor':
+            return `descriptor:${launch.kind}/${launch.id}`;
+        case 'platform-component':
+            return `platform:${launch.componentId}@${launch.version}`;
+        case 'applet-artifact':
+            return `applet:${launch.artifactId}`;
+        case 'external-url':
+            return `url:${launch.href}`;
+        default: {
+            const _exhaustive = launch;
+            return String(_exhaustive);
+        }
+    }
+}
+/**
+ * Find an app by id from a mount payload app list.
+ */
+export function findAppById(apps, appId) {
+    return apps.find((app) => app.id === appId);
+}
+/**
+ * Launcher listing: apps sorted for dock/palette (available first, then name).
+ */
+export function sortAppsForLauncher(apps) {
+    const rank = {
+        available: 0,
+        degraded: 1,
+        unknown: 2,
+        unavailable: 3
+    };
+    return [...apps].sort((a, b) => {
+        const dr = rank[a.availability.status] - rank[b.availability.status];
+        if (dr !== 0)
+            return dr;
+        return a.name.localeCompare(b.name);
+    });
+}
+//# sourceMappingURL=launch-resolution.js.map

package/dist/shell/launch-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-resolution.js","sourceRoot":"","sources":["../../src/shell/launch-resolution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwCH,SAAS,aAAa,CAAC,MAAqC;IAC3D,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,OAAO;YACX,OAAO,CAAC,CAAC;QACV,KAAK,aAAa;YACjB,OAAO,CAAC,CAAC;QACV,KAAK,SAAS;YACb,OAAO,CAAC,CAAC;QACV,KAAK,SAAS;YACb,OAAO,CAAC,CAAC;QACV;YACC,OAAO,CAAC,CAAC;IACX,CAAC;AACF,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAqC;IACvE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,4BAA4B,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAC5F,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IAC/F,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAE9F,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO;YACN,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ;YAC1D,eAAe,EAAE,EAAE;SACnB,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO;YACN,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO;YACN,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACpC,OAAO;YACN,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC;IACH,CAAC;IAED,OAAO;QACN,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,eAAe,EAAE,EAAE;KACnB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CACnB,SAAmC,EACnC,eAAyC;IAEzC,MAAM,IAAI,GAAG;QACZ,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,WAAW,EAAE,CAAC;KACd,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,GAAwB,EACxB,iBAAiD,EAAE,EACnD,aAAyC,EAAE,EAC3C,UAAgC,EAAE;IAElC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,KAAK,KAAK,CAAC;IAC5D,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5F,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,mBAAmB,GAAG,WAAW;SACrC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC;SACzC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEzB,MAAM,OAAO,GAAuB;QACnC,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,MAAM;QAC/B,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,OAAO;KACjC,CAAC;IAEF,MAAM,aAAa,GAA0B,gBAAgB;QAC5D,CAAC,CAAC,yBAAyB,CAAC,WAAW,CAAC;QACxC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAE7D,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC;IAE1D,MAAM,OAAO,GAAG,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,SAAS,CAAC;IACxF,4EAA4E;IAC5E,4EAA4E;IAC5E,MAAM,oBAAoB,GACzB,MAAM,KAAK,aAAa,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEvF,OAAO;QACN,KAAK,EAAE,GAAG,CAAC,EAAE;QACb,OAAO,EAAE,GAAG,CAAC,IAAI;QACjB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO;QACP,MAAM;QACN,OAAO;QACP,eAAe,EAAE,aAAa,CAAC,eAAe;QAC9C,mBAAmB;QACnB,oBAAoB;KACpB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA0B;IAC9D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,kBAAkB;YACtB,OAAO,aAAa,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACxF,KAAK,gBAAgB;YACpB,OAAO,WAAW,MAAM,CAAC,SAAS,EAAE,CAAC;QACtC,KAAK,iBAAiB;YACrB,OAAO,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC;QAC/B,KAAK,gBAAgB;YACpB,OAAO,UAAU,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACnD,KAAK,SAAS;YACb,OAAO,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,MAAM;YACV,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QAChC,KAAK,iBAAiB;YACrB,OAAO,UAAU,MAAM,CAAC,UAAU,EAAE,CAAC;QACtC,KAAK,YAAY;YAChB,OAAO,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACjC,KAAK,oBAAoB;YACxB,OAAO,cAAc,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACjD,KAAK,oBAAoB;YACxB,OAAO,YAAY,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC3D,KAAK,iBAAiB;YACrB,OAAO,UAAU,MAAM,CAAC,UAAU,EAAE,CAAC;QACtC,KAAK,cAAc;YAClB,OAAO,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,MAAM,CAAC;YAClC,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;IACF,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAC1B,IAAoC,EACpC,KAAa;IAEb,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAoC;IACvE,MAAM,IAAI,GAAG;QACZ,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;KACd,CAAC;IACF,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/shell/layout-grid.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Grid snap helpers for the Vessel infinite canvas shell.
+ */
+export interface GridPoint {
+    x: number;
+    y: number;
+}
+export interface GridSize {
+    width: number;
+    height: number;
+}
+export declare const VESSEL_DEFAULT_GRID: {
+    /** Base cell size in CSS pixels. */
+    readonly cell: 24;
+    /** Soft margin from canvas origin when cascading new windows. */
+    readonly cascadeStep: 28;
+};
+export declare function snapToGrid(value: number, cell?: number): number;
+export declare function snapPointToGrid(point: GridPoint, cell?: number): GridPoint;
+export declare function snapRectToGrid(rect: GridPoint & GridSize, cell?: number): GridPoint & GridSize;
+/**
+ * Cascade origin for the n-th new window so stacks stay readable on the canvas.
+ */
+export declare function cascadeOrigin(index: number, base?: GridPoint, step?: number): GridPoint;
+/**
+ * World → screen for a pannable canvas (origin is pan offset).
+ */
+export declare function worldToScreen(world: GridPoint, pan: GridPoint, zoom?: number): GridPoint;
+export declare function screenToWorld(screen: GridPoint, pan: GridPoint, zoom?: number): GridPoint;
+//# sourceMappingURL=layout-grid.d.ts.map

package/dist/shell/layout-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-grid.d.ts","sourceRoot":"","sources":["../../src/shell/layout-grid.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAED,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,mBAAmB;IAC/B,oCAAoC;;IAEpC,iEAAiE;;CAExD,CAAC;AAEX,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiC,GAAG,MAAM,CAGzF;AAED,wBAAgB,eAAe,CAC9B,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE,MAAiC,GACrC,SAAS,CAKX;AAED,wBAAgB,cAAc,CAC7B,IAAI,EAAE,SAAS,GAAG,QAAQ,EAC1B,IAAI,GAAE,MAAiC,GACrC,SAAS,GAAG,QAAQ,CAOtB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAA4B,EAClC,IAAI,GAAE,MAAwC,GAC5C,SAAS,CAMX;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,IAAI,GAAE,MAAU,GACd,SAAS,CAMX;AAED,wBAAgB,aAAa,CAC5B,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,SAAS,EACd,IAAI,GAAE,MAAU,GACd,SAAS,CAMX"}

package/dist/shell/layout-grid.js

@@ -0,0 +1,56 @@
+/**
+ * Grid snap helpers for the Vessel infinite canvas shell.
+ */
+export const VESSEL_DEFAULT_GRID = {
+    /** Base cell size in CSS pixels. */
+    cell: 24,
+    /** Soft margin from canvas origin when cascading new windows. */
+    cascadeStep: 28
+};
+export function snapToGrid(value, cell = VESSEL_DEFAULT_GRID.cell) {
+    if (cell <= 0)
+        return Math.round(value);
+    return Math.round(value / cell) * cell;
+}
+export function snapPointToGrid(point, cell = VESSEL_DEFAULT_GRID.cell) {
+    return {
+        x: snapToGrid(point.x, cell),
+        y: snapToGrid(point.y, cell)
+    };
+}
+export function snapRectToGrid(rect, cell = VESSEL_DEFAULT_GRID.cell) {
+    return {
+        x: snapToGrid(rect.x, cell),
+        y: snapToGrid(rect.y, cell),
+        width: Math.max(cell, snapToGrid(rect.width, cell)),
+        height: Math.max(cell, snapToGrid(rect.height, cell))
+    };
+}
+/**
+ * Cascade origin for the n-th new window so stacks stay readable on the canvas.
+ */
+export function cascadeOrigin(index, base = { x: 72, y: 72 }, step = VESSEL_DEFAULT_GRID.cascadeStep) {
+    const n = Math.max(0, Math.floor(index));
+    return {
+        x: base.x + n * step,
+        y: base.y + n * step
+    };
+}
+/**
+ * World → screen for a pannable canvas (origin is pan offset).
+ */
+export function worldToScreen(world, pan, zoom = 1) {
+    const z = zoom <= 0 ? 1 : zoom;
+    return {
+        x: (world.x - pan.x) * z,
+        y: (world.y - pan.y) * z
+    };
+}
+export function screenToWorld(screen, pan, zoom = 1) {
+    const z = zoom <= 0 ? 1 : zoom;
+    return {
+        x: screen.x / z + pan.x,
+        y: screen.y / z + pan.y
+    };
+}
+//# sourceMappingURL=layout-grid.js.map

package/dist/shell/layout-grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-grid.js","sourceRoot":"","sources":["../../src/shell/layout-grid.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,oCAAoC;IACpC,IAAI,EAAE,EAAE;IACR,iEAAiE;IACjE,WAAW,EAAE,EAAE;CACN,CAAC;AAEX,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAAe,mBAAmB,CAAC,IAAI;IAChF,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAC9B,KAAgB,EAChB,OAAe,mBAAmB,CAAC,IAAI;IAEvC,OAAO;QACN,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QAC5B,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;KAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAC7B,IAA0B,EAC1B,OAAe,mBAAmB,CAAC,IAAI;IAEvC,OAAO;QACN,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;QAC3B,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;QAC3B,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;KACrD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,KAAa,EACb,OAAkB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAClC,OAAe,mBAAmB,CAAC,WAAW;IAE9C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,OAAO;QACN,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI;QACpB,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI;KACpB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,KAAgB,EAChB,GAAc,EACd,OAAe,CAAC;IAEhB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/B,OAAO;QACN,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACxB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;KACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAC5B,MAAiB,EACjB,GAAc,EACd,OAAe,CAAC;IAEhB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/B,OAAO;QACN,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;QACvB,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;KACvB,CAAC;AACH,CAAC"}

package/dist/shell/owner-surface-lifecycle.d.ts

@@ -0,0 +1,30 @@
+/** Why a Vessel owner surface is being asked to close. */
+export type VesselOwnerSurfaceCloseReason = 'window-close';
+/**
+ * A close request stays pending until the owner calls `continueClose`.
+ * Owners use this continuation after their own save/discard/cancel decision.
+ */
+export interface VesselOwnerSurfaceCloseRequest {
+    readonly reason: VesselOwnerSurfaceCloseReason;
+    continueClose(): void;
+}
+export type VesselOwnerSurfaceBeforeClose = (request: VesselOwnerSurfaceCloseRequest) => void;
+/** Owner half of the generic Vessel window lifecycle seam. */
+export interface VesselOwnerSurfaceLifecycle {
+    beforeClose(handler: VesselOwnerSurfaceBeforeClose): () => void;
+}
+/** Shell half of the generic Vessel window lifecycle seam. */
+export interface VesselOwnerSurfaceLifecycleController {
+    readonly lifecycle: VesselOwnerSurfaceLifecycle;
+    requestClose(continueClose: () => void): void;
+    dispose(): void;
+}
+/**
+ * Create one lifecycle controller per mounted Vessel window.
+ *
+ * A surface may install one current guard. With no guard, the shell closes
+ * immediately. With a guard, the owner decides when (or whether) to continue.
+ * Continuations are single-use and become inert after the window is disposed.
+ */
+export declare function createVesselOwnerSurfaceLifecycle(): VesselOwnerSurfaceLifecycleController;
+//# sourceMappingURL=owner-surface-lifecycle.d.ts.map

package/dist/shell/owner-surface-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-surface-lifecycle.d.ts","sourceRoot":"","sources":["../../src/shell/owner-surface-lifecycle.ts"],"names":[],"mappings":"AACA,0DAA0D;AAC1D,MAAM,MAAM,6BAA6B,GAAG,cAAc,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAC/C,aAAa,IAAI,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,EAAE,8BAA8B,KAAK,IAAI,CAAC;AAE9F,8DAA8D;AAC9D,MAAM,WAAW,2BAA2B;IAC3C,WAAW,CAAC,OAAO,EAAE,6BAA6B,GAAG,MAAM,IAAI,CAAC;CAChE;AAED,8DAA8D;AAC9D,MAAM,WAAW,qCAAqC;IACrD,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,YAAY,CAAC,aAAa,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC9C,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,IAAI,qCAAqC,CA4CzF"}

package/dist/shell/owner-surface-lifecycle.js

@@ -0,0 +1,54 @@
+import { vesselSyncOperation } from "../boundary.js";
+/**
+ * Create one lifecycle controller per mounted Vessel window.
+ *
+ * A surface may install one current guard. With no guard, the shell closes
+ * immediately. With a guard, the owner decides when (or whether) to continue.
+ * Continuations are single-use and become inert after the window is disposed.
+ */
+export function createVesselOwnerSurfaceLifecycle() {
+    let beforeClose = null;
+    let disposed = false;
+    const lifecycle = Object.freeze({
+        beforeClose(handler) {
+            if (disposed)
+                return () => { };
+            beforeClose = handler;
+            let registered = true;
+            return () => {
+                if (!registered)
+                    return;
+                registered = false;
+                if (beforeClose === handler)
+                    beforeClose = null;
+            };
+        }
+    });
+    return {
+        lifecycle,
+        requestClose(continueClose) {
+            if (disposed)
+                return;
+            const handler = beforeClose;
+            if (!handler) {
+                vesselSyncOperation(continueClose, 'vessel-close-continuation-failed');
+                return;
+            }
+            let continued = false;
+            vesselSyncOperation(() => handler(Object.freeze({
+                reason: 'window-close',
+                continueClose() {
+                    if (disposed || continued)
+                        return;
+                    continued = true;
+                    vesselSyncOperation(continueClose, 'vessel-close-continuation-failed');
+                }
+            })), 'vessel-close-guard-failed');
+        },
+        dispose() {
+            disposed = true;
+            beforeClose = null;
+        }
+    };
+}
+//# sourceMappingURL=owner-surface-lifecycle.js.map

package/dist/shell/owner-surface-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-surface-lifecycle.js","sourceRoot":"","sources":["../../src/shell/owner-surface-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA2BrD;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC;IAChD,IAAI,WAAW,GAAyC,IAAI,CAAC;IAC7D,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,SAAS,GAAgC,MAAM,CAAC,MAAM,CAAC;QAC5D,WAAW,CAAC,OAAsC;YACjD,IAAI,QAAQ;gBAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;YAC9B,WAAW,GAAG,OAAO,CAAC;YACtB,IAAI,UAAU,GAAG,IAAI,CAAC;YACtB,OAAO,GAAG,EAAE;gBACX,IAAI,CAAC,UAAU;oBAAE,OAAO;gBACxB,UAAU,GAAG,KAAK,CAAC;gBACnB,IAAI,WAAW,KAAK,OAAO;oBAAE,WAAW,GAAG,IAAI,CAAC;YACjD,CAAC,CAAC;QACH,CAAC;KACD,CAAC,CAAC;IAEH,OAAO;QACN,SAAS;QACT,YAAY,CAAC,aAAyB;YACrC,IAAI,QAAQ;gBAAE,OAAO;YACrB,MAAM,OAAO,GAAG,WAAW,CAAC;YAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,mBAAmB,CAAC,aAAa,EAAE,kCAAkC,CAAC,CAAC;gBACvE,OAAO;YACR,CAAC;YAED,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,mBAAmB,CAAC,GAAG,EAAE,CAAC,OAAO,CAChC,MAAM,CAAC,MAAM,CAAC;gBACb,MAAM,EAAE,cAAuB;gBAC/B,aAAa;oBACZ,IAAI,QAAQ,IAAI,SAAS;wBAAE,OAAO;oBAClC,SAAS,GAAG,IAAI,CAAC;oBACjB,mBAAmB,CAAC,aAAa,EAAE,kCAAkC,CAAC,CAAC;gBACxE,CAAC;aACD,CAAC,CACF,EAAE,2BAA2B,CAAC,CAAC;QACjC,CAAC;QACD,OAAO;YACN,QAAQ,GAAG,IAAI,CAAC;YAChB,WAAW,GAAG,IAAI,CAAC;QACpB,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/shell/ports.d.ts

@@ -0,0 +1,107 @@
+/**
+ * App I/O ports and wires for the Vessel canvas.
+ *
+ * Framework-neutral contracts so vessel/app surfaces (and future wrappers) can
+ * declare inputs/outputs with schemas. The xyflow canvas uses these as Handles;
+ * magnetic links and permanent/temporary wires validate against canConnectPorts.
+ */
+import * as z from 'zod/v4';
+import { type VesselAppDescriptor } from '../schemas.ts';
+export declare const vesselPortDirectionSchema: z.ZodEnum<{
+    output: "output";
+    input: "input";
+}>;
+export type VesselPortDirection = z.infer<typeof vesselPortDirectionSchema>;
+/** Lightweight schema fingerprint for compatibility (full JSON Schema later). */
+export declare const vesselPortSchemaRefSchema: z.ZodObject<{
+    mediaType: z.ZodDefault<z.ZodString>;
+    schemaId: z.ZodOptional<z.ZodString>;
+    shape: z.ZodDefault<z.ZodEnum<{
+        any: "any";
+        event: "event";
+        stream: "stream";
+        json: "json";
+        text: "text";
+        binary: "binary";
+    }>>;
+}, z.core.$strip>;
+export type VesselPortSchemaRef = z.infer<typeof vesselPortSchemaRefSchema>;
+export declare const vesselAppPortSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    direction: z.ZodEnum<{
+        output: "output";
+        input: "input";
+    }>;
+    schema: z.ZodDefault<z.ZodObject<{
+        mediaType: z.ZodDefault<z.ZodString>;
+        schemaId: z.ZodOptional<z.ZodString>;
+        shape: z.ZodDefault<z.ZodEnum<{
+            any: "any";
+            event: "event";
+            stream: "stream";
+            json: "json";
+            text: "text";
+            binary: "binary";
+        }>>;
+    }, z.core.$strip>>;
+    multiple: z.ZodDefault<z.ZodBoolean>;
+    required: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type VesselAppPort = z.infer<typeof vesselAppPortSchema>;
+export declare const vesselWireKindSchema: z.ZodEnum<{
+    temporary: "temporary";
+    permanent: "permanent";
+}>;
+export type VesselWireKind = z.infer<typeof vesselWireKindSchema>;
+export declare const vesselWireEdgeSchema: z.ZodObject<{
+    id: z.ZodString;
+    sourceInstanceId: z.ZodString;
+    sourcePortId: z.ZodString;
+    targetInstanceId: z.ZodString;
+    targetPortId: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<{
+        temporary: "temporary";
+        permanent: "permanent";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type VesselWireEdge = z.infer<typeof vesselWireEdgeSchema>;
+/** Default ports every launchable app gets until descriptors declare their own. */
+export declare function defaultPortsForApp(_app: VesselAppDescriptor): VesselAppPort[];
+/**
+ * Resolve ports for an app.
+ *
+ * Prefer **descriptor-declared** `app.ports` when present (apps/wrappers name their
+ * I/O + schemas). Otherwise fall back to defaults + **temporary** tag heuristics
+ * (`files` / `chat` tags). Tag heuristics are not the long-term contract — migrate
+ * descriptors to declare `ports` explicitly.
+ */
+export declare function portsForApp(app: VesselAppDescriptor): VesselAppPort[];
+export interface PortConnectResult {
+    ok: boolean;
+    reason?: string;
+}
+/** Shape compatibility matrix for early magnetic linking. */
+export declare function portContractsCompatible(a: VesselPortSchemaRef['shape'], b: VesselPortSchemaRef['shape']): boolean;
+export declare function canConnectPorts(source: VesselAppPort, target: VesselAppPort, options?: {
+    allowSelf?: boolean;
+    sourceInstanceId?: string;
+    targetInstanceId?: string;
+}): PortConnectResult;
+declare const wireInputSchema: z.ZodObject<{
+    kind: z.ZodDefault<z.ZodEnum<{
+        temporary: "temporary";
+        permanent: "permanent";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    sourceInstanceId: z.ZodString;
+    sourcePortId: z.ZodString;
+    targetInstanceId: z.ZodString;
+    targetPortId: z.ZodString;
+}, z.core.$strip>;
+export declare function createWireEdge(input: z.input<typeof wireInputSchema>): VesselWireEdge;
+/** Compatibility export retained for existing callers. */
+export { portContractsCompatible as shapesCompatible };
+//# sourceMappingURL=ports.d.ts.map

package/dist/shell/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/shell/ports.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAkC,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzF,eAAO,MAAM,yBAAyB;;;EAA8B,CAAC;AACrE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,iFAAiF;AACjF,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAOpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;iBAAiC,CAAC;AAElE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB;;;EAAqC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAS/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,EAAE,CAwB7E;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,mBAAmB,GAAG,aAAa,EAAE,CA6BrE;AAED,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,OAAO,CAOjH;AAED,wBAAgB,eAAe,CAC9B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GACzF,iBAAiB,CAoCnB;AAED,QAAA,MAAM,eAAe;;;;;;;;;;iBAA2D,CAAC;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GAAG,cAAc,CAYrF;AAED,0DAA0D;AAC1D,OAAO,EAAE,uBAAuB,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/shell/ports.js

@@ -0,0 +1,154 @@
+import { parseVesselValue } from "../boundary.js";
+/**
+ * App I/O ports and wires for the Vessel canvas.
+ *
+ * Framework-neutral contracts so vessel/app surfaces (and future wrappers) can
+ * declare inputs/outputs with schemas. The xyflow canvas uses these as Handles;
+ * magnetic links and permanent/temporary wires validate against canConnectPorts.
+ */
+import * as z from 'zod/v4';
+import { vesselAppPortDeclarationSchema } from "../schemas.js";
+export const vesselPortDirectionSchema = z.enum(['input', 'output']);
+/** Lightweight schema fingerprint for compatibility (full JSON Schema later). */
+export const vesselPortSchemaRefSchema = z.object({
+    /** Logical type id, e.g. `text/plain`, `application/json`, `vessel/event`. */
+    mediaType: z.string().min(1).default('application/json'),
+    /** Optional named schema id in a registry. */
+    schemaId: z.string().min(1).optional(),
+    /** Free-form shape hint for early UX (not a full schema validator yet). */
+    shape: z.enum(['any', 'text', 'json', 'event', 'stream', 'binary']).default('any')
+});
+export const vesselAppPortSchema = vesselAppPortDeclarationSchema;
+export const vesselWireKindSchema = z.enum(['temporary', 'permanent']);
+export const vesselWireEdgeSchema = z.object({
+    id: z.string().min(1),
+    sourceInstanceId: z.string().min(1),
+    sourcePortId: z.string().min(1),
+    targetInstanceId: z.string().min(1),
+    targetPortId: z.string().min(1),
+    kind: vesselWireKindSchema.default('temporary'),
+    label: z.string().optional(),
+    createdAt: z.string().datetime().optional()
+});
+/** Default ports every launchable app gets until descriptors declare their own. */
+export function defaultPortsForApp(_app) {
+    return [
+        vesselAppPortSchema.parse({
+            id: 'in.default',
+            label: 'In',
+            direction: 'input',
+            schema: { mediaType: 'application/json', shape: 'any' },
+            multiple: true
+        }),
+        vesselAppPortSchema.parse({
+            id: 'out.default',
+            label: 'Out',
+            direction: 'output',
+            schema: { mediaType: 'application/json', shape: 'event' },
+            multiple: true
+        }),
+        vesselAppPortSchema.parse({
+            id: 'out.events',
+            label: 'Events',
+            direction: 'output',
+            schema: { mediaType: 'vessel/event', shape: 'event' },
+            multiple: true
+        })
+    ];
+}
+/**
+ * Resolve ports for an app.
+ *
+ * Prefer **descriptor-declared** `app.ports` when present (apps/wrappers name their
+ * I/O + schemas). Otherwise fall back to defaults + **temporary** tag heuristics
+ * (`files` / `chat` tags). Tag heuristics are not the long-term contract — migrate
+ * descriptors to declare `ports` explicitly.
+ */
+export function portsForApp(app) {
+    const declared = app.ports;
+    if (Array.isArray(declared) && declared.length > 0) {
+        return declared.map((p) => parseVesselValue(vesselAppPortSchema, p));
+    }
+    const ports = defaultPortsForApp(app);
+    // TEMPORARY tag heuristics — remove once descriptors declare ports.
+    if (app.tags.includes('files')) {
+        ports.push(vesselAppPortSchema.parse({
+            id: 'out.document',
+            label: 'Document',
+            direction: 'output',
+            schema: { mediaType: 'text/plain', shape: 'text' }
+        }));
+    }
+    if (app.tags.includes('chat') || app.id === 'workspace.chat') {
+        ports.push(vesselAppPortSchema.parse({
+            id: 'in.message',
+            label: 'Message',
+            direction: 'input',
+            schema: { mediaType: 'text/plain', shape: 'text' }
+        }));
+    }
+    return ports;
+}
+/** Shape compatibility matrix for early magnetic linking. */
+export function portContractsCompatible(a, b) {
+    if (a === 'any' || b === 'any')
+        return true;
+    if (a === b)
+        return true;
+    // events accept json payloads
+    if ((a === 'event' && b === 'json') || (a === 'json' && b === 'event'))
+        return true;
+    if ((a === 'text' && b === 'json') || (a === 'json' && b === 'text'))
+        return true;
+    return false;
+}
+export function canConnectPorts(source, target, options = {}) {
+    source = parseVesselValue(vesselAppPortSchema, source);
+    target = parseVesselValue(vesselAppPortSchema, target);
+    options = parseVesselValue(z.object({ allowSelf: z.boolean().optional(), sourceInstanceId: z.string().optional(), targetInstanceId: z.string().optional() }), options);
+    if (source.direction !== 'output') {
+        return { ok: false, reason: 'Source port must be an output.' };
+    }
+    if (target.direction !== 'input') {
+        return { ok: false, reason: 'Target port must be an input.' };
+    }
+    if (!options.allowSelf &&
+        options.sourceInstanceId &&
+        options.targetInstanceId &&
+        options.sourceInstanceId === options.targetInstanceId) {
+        return { ok: false, reason: 'Cannot wire an app to itself.' };
+    }
+    if (!portContractsCompatible(source.schema.shape, target.schema.shape)) {
+        return {
+            ok: false,
+            reason: `Incompatible shapes: ${source.schema.shape} → ${target.schema.shape}`
+        };
+    }
+    if (source.schema.schemaId &&
+        target.schema.schemaId &&
+        source.schema.schemaId !== target.schema.schemaId &&
+        target.schema.shape !== 'any') {
+        return {
+            ok: false,
+            reason: `Schema mismatch: named schema ids differ.`
+        };
+    }
+    return { ok: true };
+}
+const wireInputSchema = vesselWireEdgeSchema.omit({ id: true, createdAt: true });
+export function createWireEdge(input) {
+    const parsed = parseVesselValue(wireInputSchema, input);
+    return parseVesselValue(vesselWireEdgeSchema, {
+        id: `wire:${parsed.sourceInstanceId}:${parsed.sourcePortId}->${parsed.targetInstanceId}:${parsed.targetPortId}:${Date.now()}`,
+        sourceInstanceId: parsed.sourceInstanceId,
+        sourcePortId: parsed.sourcePortId,
+        targetInstanceId: parsed.targetInstanceId,
+        targetPortId: parsed.targetPortId,
+        kind: parsed.kind,
+        label: parsed.label,
+        createdAt: new Date().toISOString()
+    });
+}
+/** Compatibility export retained for existing callers. */
+export { portContractsCompatible as shapesCompatible };
+//# sourceMappingURL=ports.js.map

package/dist/shell/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/shell/ports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,8BAA8B,EAA4B,MAAM,eAAe,CAAC;AAEzF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGrE,iFAAiF;AACjF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,8EAA8E;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACxD,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,2EAA2E;IAC3E,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAClF,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAIlE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAGvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,WAAW,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAIH,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,IAAyB;IAC3D,OAAO;QACN,mBAAmB,CAAC,KAAK,CAAC;YACzB,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,OAAO;YAClB,MAAM,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE;YACvD,QAAQ,EAAE,IAAI;SACd,CAAC;QACF,mBAAmB,CAAC,KAAK,CAAC;YACzB,EAAE,EAAE,aAAa;YACjB,KAAK,EAAE,KAAK;YACZ,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE;YACzD,QAAQ,EAAE,IAAI;SACd,CAAC;QACF,mBAAmB,CAAC,KAAK,CAAC;YACzB,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE;YACrD,QAAQ,EAAE,IAAI;SACd,CAAC;KACF,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,GAAwB;IACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,oEAAoE;IACpE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CACT,mBAAmB,CAAC,KAAK,CAAC;YACzB,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE;SAClD,CAAC,CACF,CAAC;IACH,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,gBAAgB,EAAE,CAAC;QAC9D,KAAK,CAAC,IAAI,CACT,mBAAmB,CAAC,KAAK,CAAC;YACzB,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,OAAO;YAClB,MAAM,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE;SAClD,CAAC,CACF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAOD,6DAA6D;AAC7D,MAAM,UAAU,uBAAuB,CAAC,CAA+B,EAAE,CAA+B;IACvG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,8BAA8B;IAC9B,IAAI,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACpF,IAAI,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAClF,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAC9B,MAAqB,EACrB,MAAqB,EACrB,UAAyF,EAAE;IAE3F,MAAM,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACvK,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;QAClC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;IAC/D,CAAC;IACD,IACC,CAAC,OAAO,CAAC,SAAS;QAClB,OAAO,CAAC,gBAAgB;QACxB,OAAO,CAAC,gBAAgB;QACxB,OAAO,CAAC,gBAAgB,KAAK,OAAO,CAAC,gBAAgB,EACpD,CAAC;QACF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO;YACN,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,wBAAwB,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;SAC9E,CAAC;IACH,CAAC;IACD,IACC,MAAM,CAAC,MAAM,CAAC,QAAQ;QACtB,MAAM,CAAC,MAAM,CAAC,QAAQ;QACtB,MAAM,CAAC,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,CAAC,QAAQ;QACjD,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,KAAK,EAC5B,CAAC;QACF,OAAO;YACN,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,2CAA2C;SACnD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,eAAe,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACjF,MAAM,UAAU,cAAc,CAAC,KAAsC;IACpE,MAAM,MAAM,GAAG,gBAAgB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACxD,OAAO,gBAAgB,CAAC,oBAAoB,EAAE;QAC7C,EAAE,EAAE,QAAQ,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;QAC7H,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,OAAO,EAAE,uBAAuB,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/shell/types.d.ts

@@ -0,0 +1,7 @@
+export type VesselAvailabilityStatus = 'available' | 'degraded' | 'unavailable' | 'unknown';
+export interface VesselAvailability {
+    status: VesselAvailabilityStatus;
+    summary: string;
+    lastCheckedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shell/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAE5F,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,wBAAwB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB"}