yarramate 0.18.0 → 0.19.0

package/dist/adapters/visual/request.js

@@ -0,0 +1,131 @@
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { loadProjection } from '../../projection.js';
+import { loadWorkspaceManifest } from '../../workspace.js';
+import { parseVisualSessionRequest } from './protocol.js';
+import { buildVisualModelGraph } from './session-store.js';
+/**
+ * The one manifest a session can serve. `startVisualServer` resolves exactly
+ * this path relative to its own working directory, so the builder reads the
+ * same file rather than accepting a path that could name a different workspace
+ * than the session about to render it.
+ */
+const MANIFEST_PATH = '.yarramate/workspace.yaml';
+const requestDiagnostic = (code, message, path = MANIFEST_PATH) => ({
+    severity: 'error',
+    code,
+    message,
+    path,
+    pointer: '/',
+    line: 1,
+    column: 1,
+});
+const digestOf = (source) => createHash('sha256').update(source).digest('hex');
+/**
+ * Builds the `yarramate/visual-session-request/v1` document that `start`
+ * consumes, from the workspace on disk.
+ *
+ * The request carries a whole compiled model — 247 nodes and 338 edges for this
+ * repository's own architecture — so it is a machine's transcription of the
+ * workspace, never something an agent can honestly hand-author. Every input the
+ * document needs is already derivable: the graph from the native compiler, the
+ * digests from the same sources that compiled, and the view list from the
+ * workspace's declared projections.
+ *
+ * The result is validated through `parseVisualSessionRequest` before it is
+ * returned, so the byte ceiling, digest confinement, and authority agreement
+ * are the protocol's own rules rather than a second set restated here. A
+ * builder that cannot produce a valid document refuses instead of handing a
+ * session something it would reject at start.
+ */
+export const buildVisualSessionRequest = (options) => {
+    const manifestPath = resolve(options.cwd, MANIFEST_PATH);
+    let manifestSource;
+    try {
+        manifestSource = readFileSync(manifestPath, 'utf8');
+    }
+    catch {
+        return {
+            ok: false,
+            diagnostics: [
+                requestDiagnostic('YMVS410', `Workspace manifest ${manifestPath} cannot be read`),
+            ],
+        };
+    }
+    const loaded = loadWorkspaceManifest({ path: manifestPath, source: manifestSource }, options.cwd);
+    if (!loaded.ok) {
+        return { ok: false, diagnostics: loaded.diagnostics };
+    }
+    const workspace = loaded.workspace;
+    // Same order the session's own recompile uses, so the request's graph and
+    // every graph the session rebuilds after a commit come from one input list.
+    const sourcePaths = [...workspace.profiles, ...workspace.documents];
+    const sources = [];
+    for (const path of sourcePaths) {
+        try {
+            sources.push({ path, source: readFileSync(resolve(options.cwd, path), 'utf8') });
+        }
+        catch {
+            return {
+                ok: false,
+                diagnostics: [
+                    requestDiagnostic('YMVS411', `Workspace source ${path} cannot be read`, path),
+                ],
+            };
+        }
+    }
+    const built = buildVisualModelGraph(sources);
+    if (!built.ok)
+        return { ok: false, diagnostics: built.diagnostics };
+    // A projection that does not load is skipped by the session too: the request
+    // names a view the browser will actually be able to open.
+    const viewIds = workspace.projections.flatMap((projectionPath) => {
+        try {
+            const projection = loadProjection({
+                path: projectionPath,
+                source: readFileSync(resolve(options.cwd, projectionPath), 'utf8'),
+            });
+            return projection.ok ? [projection.projection.id] : [];
+        }
+        catch {
+            return [];
+        }
+    });
+    const initialView = options.initialView ?? viewIds[0];
+    if (initialView === undefined) {
+        return {
+            ok: false,
+            diagnostics: [
+                requestDiagnostic('YMVS412', `Workspace ${workspace.id} declares no loadable projection, so a session has no view to open`),
+            ],
+        };
+    }
+    if (!viewIds.includes(initialView)) {
+        return {
+            ok: false,
+            diagnostics: [
+                requestDiagnostic('YMVS413', `Workspace ${workspace.id} declares no projection "${initialView}": ${viewIds.length === 0 ? 'it declares none' : viewIds.join(', ')}`),
+            ],
+        };
+    }
+    const request = {
+        format: 'yarramate/visual-session-request/v1',
+        authority: 'canonical',
+        title: options.title ?? workspace.id,
+        description: options.description ??
+            `Native rendering of workspace ${workspace.id} from ${MANIFEST_PATH}`,
+        chatEnabled: options.chatEnabled ?? false,
+        initialModel: {
+            format: 'yarramate/visual-model/v1',
+            authority: 'canonical',
+            initialView,
+            sourceDigests: Object.fromEntries(sources.map(({ path, source }) => [path, digestOf(source)])),
+            graph: built.graph,
+        },
+    };
+    const parsed = parseVisualSessionRequest(request);
+    if (!parsed.ok)
+        return { ok: false, diagnostics: parsed.diagnostics };
+    return { ok: true, request: parsed.value };
+};

package/dist/adapters/visual/session-server.d.ts

@@ -1,6 +1,6 @@
-import { type VisualDiagnostic, type VisualEvent, type VisualFreezeReason, type VisualHandoff, type VisualLifecycle, type VisualSessionRequest, type VisualSessionStarted, type VisualStatus, type VisualTerminationReason } from './protocol.js';
-import { type TerminalEventDependencies, type VisualSessionPaths } from './session-store.js';
-import type { VisualRenderedModel, VisualServerFrame, VisualSessionSnapshot, VisualTranscriptRecord } from './wire.js';
+import { type VisualDiagnostic, type VisualEvent, type VisualFreezeReason, type VisualHandoff, type VisualLifecycle, type VisualSessionRequest, type VisualSessionStarted, type VisualStatus, type VisualTerminationReason } from "./protocol.js";
+import { type TerminalEventDependencies, type VisualSessionPaths } from "./session-store.js";
+import type { VisualRenderedModel, VisualServerFrame, VisualSessionSnapshot, VisualTranscriptRecord } from "./wire.js";
 export type { VisualRenderedModel, VisualServerFrame, VisualSessionSnapshot, VisualTranscriptRecord, };
 /**
  * Document name reported by diagnostics the server itself raises — a refused
@@ -14,9 +14,9 @@ export declare const VISUAL_SERVER_DOCUMENT = "visual-session-server";
  * and the page can be neither framed nor used as a base for relative fetches.
  */
 export declare const VISUAL_BROWSER_HEADERS: {
-    readonly 'Referrer-Policy': 'no-referrer';
-    readonly 'X-Content-Type-Options': 'nosniff';
-    readonly 'Cache-Control': 'no-store';
+    readonly "Referrer-Policy": "no-referrer";
+    readonly "X-Content-Type-Options": "nosniff";
+    readonly "Cache-Control": "no-store";
 };
 /**
  * This session's content policy. Every source stays `'self'`; the one addition
@@ -52,7 +52,6 @@ export type VisualResponseAcceptance = {
     readonly accepted: true;
     readonly duplicate: boolean;
     readonly lastSequence: number;
-    readonly model?: VisualRenderedModel;
     readonly diagnostics: readonly VisualDiagnostic[];
 } | {
     readonly accepted: false;
@@ -67,6 +66,8 @@ export interface VisualServerOptions {
     readonly request: VisualSessionRequest;
     /** Directory that holds one directory per live session. */
     readonly baseDir: string;
+    /** Working directory for resolving .yarramate/workspace.yaml and projections. */
+    readonly cwd: string;
     /** Root of the self-contained browser application. */
     readonly assetRoot?: string;
     readonly now?: () => Date;
@@ -98,8 +99,6 @@ export interface VisualServerHandle {
 export interface ActiveVisualSession {
     readonly paths: VisualSessionPaths;
     lifecycle: VisualLifecycle;
-    /** Cancels whatever the trusted compiler is doing for this session. */
-    readonly compilerAbort: AbortController;
     /** Records why the browser stopped being able to speak. */
     readonly freeze: (reason: VisualFreezeReason) => void;
     /** Settles work already admitted, so recovery reads a quiet journal. */
@@ -115,11 +114,10 @@ export interface ActiveVisualSession {
  * that failed, a browser that never came back, a cancelling main agent, or a
  * runtime shutting itself down.
  *
- * The order is the invariant. Input freezes before anything is read; the
- * compiler is cancelled rather than waited out; work already admitted is still
- * allowed to finish; exactly one terminal event is journaled; and the handoff
- * is recovered without deleting anything, so `stop` — and only `stop` — is what
- * removes the session directory.
+ * The order is the invariant. Input freezes before anything is read; work
+ * already admitted is still allowed to finish; exactly one terminal event is
+ * journaled; and the handoff is recovered without deleting anything, so
+ * `stop` — and only `stop` — is what removes the session directory.
  */
 export declare const terminateVisualSession: (session: ActiveVisualSession, reason: VisualTerminationReason) => Promise<VisualHandoff>;
 /**