@vgai/live 0.5.32 → 0.5.35

package/dist/{vgai-live/src/session.js → session.js}

@@ -46,8 +46,7 @@
  */
 import { existsSync, readFileSync, realpathSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
-import { EDITOR_SESSION_DISCOVERY_TIMEOUT_MS, HttpEditorTransport, withTimeout, } from '@vgai/sdk';
-import { servedProjectAnswer } from '../../vgai-sdk/src/editor/session-registry-format';
+import { EDITOR_SESSION_DISCOVERY_TIMEOUT_MS, HttpEditorTransport, servedProjectAnswer, withTimeout, } from '@vgai/sdk';
 /**
  * Lifted verbatim from `packages/vgai-cli/src/project-root.ts` (see this
  * module's doc comment above for why it's duplicated rather than imported).

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/live",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.32",
+  "version": "0.5.35",
   "type": "module",
   "repository": {
     "type": "git",
@@ -27,13 +27,13 @@
     "node": ">=22.0.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/check-live-build-output.mjs",
     "dev": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@vgai/editor-sdk": "0.5.32",
-    "@vgai/sdk": "0.5.32"
+    "@vgai/editor-sdk": "0.5.35",
+    "@vgai/sdk": "0.5.35"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.58.2 <2"

package/src/session.ts

@@ -52,9 +52,9 @@ import {
   type EditorSessionInfo,
   type EditorTransport,
   HttpEditorTransport,
+  servedProjectAnswer,
   withTimeout,
 } from '@vgai/sdk';
-import { servedProjectAnswer } from '../../vgai-sdk/src/editor/session-registry-format';
 
 /**
  * Lifted verbatim from `packages/vgai-cli/src/project-root.ts` (see this

package/dist/vgai-sdk/src/editor/session-registry-format.d.ts

@@ -1,81 +0,0 @@
-/**
- * `~/.vgai/editor-sessions.json` — the ONE spelling of the editor-session
- * registry contract, and the shared machinery every reader was hand-copying.
- *
- * The registry's WRITE half stays with its owner
- * (`packages/editor/server/session-registry.ts`); this module owns the
- * FORMAT: the entry shape, the shape guards, the file path, the
- * liveness-filtered read, the `/__editor/project` answer parser, and the
- * deterministic session-selection core. It existed as FOUR drifting copies
- * (server registry, the CLI, and both vgai-sdk transports) held together by
- * a "the CLI has no editor dependency" premise that had stopped being true —
- * and the drift was already real: one copy's `/__editor/project` parser
- * dropped `manifestError`, reporting a degraded session as belonging to no
- * project.
- */
-/** One registry entry, exactly as the server's write half records it. */
-export interface EditorSessionEntry {
-    /** Canonical project root currently open, or null when none. */
-    project: string | null;
-    port: number;
-    /** PID of the dev-server process. */
-    pid: number;
-    /** ISO timestamp of server start. */
-    startedAt: string;
-    sessionId: string | null;
-    /** Private loopback control credential — never returned by an editor HTTP
-     *  route; exists only in this user-private registry. */
-    controlSecret?: string | null;
-    repositoryId: string | null;
-    worktreeId: string | null;
-    worktreeRoot: string | null;
-    projectRelativePath: string | null;
-    branch: string | null;
-    headCommit: string | null;
-    baseCommit: string | null;
-}
-export declare const EDITOR_SESSIONS_REGISTRY_FILE: string;
-export declare function isEditorSessionEntry(v: unknown): v is EditorSessionEntry;
-export declare function normalizeEditorSessionEntry(session: EditorSessionEntry): EditorSessionEntry;
-export declare function pidAlive(pid: number): boolean;
-/** The registry's live entries — shape-validated and PID-liveness-filtered. */
-export declare function readLiveRegisteredSessions(): EditorSessionEntry[];
-/**
- * WHICH PROJECT a `/__editor/project` body says its server is serving.
- *
- * `serving` is that server's own statement of "I AM serving this project, I
- * just cannot describe it" (its manifest is unparseable or fails strict
- * validation) — added to the route precisely because a bare
- * `{ project: null }` is indistinguishable from "no project open". Reading
- * only `project.path` collapses the two, and the cost is that every
- * project-matched command loses a live session the moment a save breaks its
- * manifest, reporting it as belonging to no project rather than as this
- * project's degraded session.
- */
-export declare function servedProjectAnswer(body: unknown): {
-    path: string | null;
-    manifestError: string | null;
-};
-/**
- * Deterministic session selection — the ONE precedence order every surface
- * follows: explicit `ctx.editorUrl` probe > port match against the listing >
- * `ctx.projectRoot` match > lowest live port > not-running. Generic over the
- * session shape so the editor and play transports (whose probe results
- * differ) share the algorithm rather than a copy of it.
- */
-export declare function resolveRegisteredSession<T extends {
-    port: number;
-    project: string | null;
-    url?: string;
-}>(ctx: {
-    editorUrl?: string | undefined;
-    projectRoot?: string | undefined;
-}, transport: {
-    listSessions(timeoutMs: number): Promise<T[]>;
-    probeSessionUrl?: ((url: string, timeoutMs: number) => Promise<T | null | undefined>) | undefined;
-}, options: {
-    probeTimeoutMs: number;
-    discoveryTimeoutMs: number;
-    withTimeout: <V>(work: Promise<V>, timeoutMs: number, what: string) => Promise<V>;
-    notRunning: () => never;
-}): Promise<T>;

package/dist/vgai-sdk/src/editor/session-registry-format.js

@@ -1,158 +0,0 @@
-/**
- * `~/.vgai/editor-sessions.json` — the ONE spelling of the editor-session
- * registry contract, and the shared machinery every reader was hand-copying.
- *
- * The registry's WRITE half stays with its owner
- * (`packages/editor/server/session-registry.ts`); this module owns the
- * FORMAT: the entry shape, the shape guards, the file path, the
- * liveness-filtered read, the `/__editor/project` answer parser, and the
- * deterministic session-selection core. It existed as FOUR drifting copies
- * (server registry, the CLI, and both vgai-sdk transports) held together by
- * a "the CLI has no editor dependency" premise that had stopped being true —
- * and the drift was already real: one copy's `/__editor/project` parser
- * dropped `manifestError`, reporting a degraded session as belonging to no
- * project.
- */
-import { readFileSync, realpathSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join, resolve } from 'node:path';
-export const EDITOR_SESSIONS_REGISTRY_FILE = join(homedir(), '.vgai', 'editor-sessions.json');
-export function isEditorSessionEntry(v) {
-    if (typeof v !== 'object' || v === null)
-        return false;
-    const s = v;
-    const optionalIdentity = (value) => value === undefined || value === null || typeof value === 'string';
-    return ((typeof s['project'] === 'string' || s['project'] === null) &&
-        typeof s['port'] === 'number' &&
-        typeof s['pid'] === 'number' &&
-        typeof s['startedAt'] === 'string' &&
-        optionalIdentity(s['sessionId']) &&
-        optionalIdentity(s['controlSecret']) &&
-        optionalIdentity(s['repositoryId']) &&
-        optionalIdentity(s['worktreeId']) &&
-        optionalIdentity(s['worktreeRoot']) &&
-        optionalIdentity(s['projectRelativePath']) &&
-        optionalIdentity(s['branch']) &&
-        optionalIdentity(s['headCommit']) &&
-        optionalIdentity(s['baseCommit']));
-}
-export function normalizeEditorSessionEntry(session) {
-    return {
-        ...session,
-        sessionId: session.sessionId ?? null,
-        controlSecret: session.controlSecret ?? null,
-        repositoryId: session.repositoryId ?? null,
-        worktreeId: session.worktreeId ?? null,
-        worktreeRoot: session.worktreeRoot ?? null,
-        projectRelativePath: session.projectRelativePath ?? null,
-        branch: session.branch ?? null,
-        headCommit: session.headCommit ?? null,
-        baseCommit: session.baseCommit ?? null,
-    };
-}
-export function pidAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** The registry's live entries — shape-validated and PID-liveness-filtered. */
-export function readLiveRegisteredSessions() {
-    try {
-        const raw = JSON.parse(readFileSync(EDITOR_SESSIONS_REGISTRY_FILE, 'utf8'));
-        return Array.isArray(raw)
-            ? raw
-                .filter(isEditorSessionEntry)
-                .map(normalizeEditorSessionEntry)
-                .filter((s) => pidAlive(s.pid))
-            : [];
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * WHICH PROJECT a `/__editor/project` body says its server is serving.
- *
- * `serving` is that server's own statement of "I AM serving this project, I
- * just cannot describe it" (its manifest is unparseable or fails strict
- * validation) — added to the route precisely because a bare
- * `{ project: null }` is indistinguishable from "no project open". Reading
- * only `project.path` collapses the two, and the cost is that every
- * project-matched command loses a live session the moment a save breaks its
- * manifest, reporting it as belonging to no project rather than as this
- * project's degraded session.
- */
-export function servedProjectAnswer(body) {
-    const b = body;
-    return {
-        path: b.project?.path ?? b.serving?.path ?? null,
-        manifestError: b.project ? null : (b.serving?.error ?? null),
-    };
-}
-/** Canonical (realpathed when possible) absolute form of a project path. */
-function canonicalizeProjectPath(p) {
-    const absolute = resolve(p);
-    try {
-        return realpathSync(absolute);
-    }
-    catch {
-        return absolute;
-    }
-}
-/** Extract the port from an `http(s)://host:port` URL, or undefined if unparseable. */
-function portOfUrl(url) {
-    try {
-        const port = new URL(url).port;
-        return port ? Number(port) : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Deterministic session selection — the ONE precedence order every surface
- * follows: explicit `ctx.editorUrl` probe > port match against the listing >
- * `ctx.projectRoot` match > lowest live port > not-running. Generic over the
- * session shape so the editor and play transports (whose probe results
- * differ) share the algorithm rather than a copy of it.
- */
-export async function resolveRegisteredSession(ctx, transport, options) {
-    const editorUrl = ctx.editorUrl;
-    if (editorUrl !== undefined && transport.probeSessionUrl) {
-        try {
-            const session = await options.withTimeout(transport.probeSessionUrl(editorUrl, options.probeTimeoutMs), options.probeTimeoutMs, 'explicit editor URL probe');
-            if (session)
-                return session;
-        }
-        catch { }
-        return options.notRunning();
-    }
-    let sessions;
-    try {
-        sessions = await options.withTimeout(transport.listSessions(options.discoveryTimeoutMs), options.discoveryTimeoutMs, 'editor session discovery');
-    }
-    catch {
-        return options.notRunning();
-    }
-    if (sessions.length === 0)
-        return options.notRunning();
-    if (editorUrl !== undefined) {
-        const port = portOfUrl(editorUrl);
-        const match = sessions.find((s) => s.port === port);
-        if (!match)
-            return options.notRunning();
-        return { ...match, url: editorUrl.replace(/\/+$/, '') };
-    }
-    if (ctx.projectRoot !== undefined) {
-        const canon = canonicalizeProjectPath(ctx.projectRoot);
-        const match = sessions.find((s) => s.project !== null && canonicalizeProjectPath(s.project) === canon);
-        if (!match)
-            return options.notRunning();
-        return match;
-    }
-    return [...sessions].sort((a, b) => a.port - b.port)[0];
-}