@xfey/tutti 0.1.53 → 0.1.55

package/dist/server-shell/http/routes/project-api/artifacts-routes.js

@@ -1,9 +1,8 @@
-import { HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewResponseSchema, GetArtifactsResponseSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewResponseSchema, } from "@tutti/shared/schemas/api";
-import { ARTIFACT_PREVIEW_REQUEST_BODY_LIMIT_BYTES, ARTIFACT_PREVIEW_CSP, ArtifactPreviewManager, isArtifactPreviewHttpMethod, readArtifactProjection, readArtifactStaticPreview, } from "../../../../artifacts/index.js";
+import { GetArtifactsResponseSchema, } from "@tutti/shared/schemas/api";
+import { ARTIFACT_PREVIEW_REQUEST_BODY_LIMIT_BYTES, ARTIFACT_PREVIEW_CSP, ArtifactPreviewManager, isArtifactPreviewHttpMethod, } from "../../../../artifacts/index.js";
 import { WorkspaceOpsError } from "../../../../workspace-ops/index.js";
-import { executeIdempotentCommand } from "../../../command-idempotency/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
-import { requireHostProjectSession, requireProjectStore, requireWorkspaceRoot, } from "./session-requirements.js";
+import { requireHostProjectSession, requireWorkspaceRoot, } from "./session-requirements.js";
 function artifactInvalidates() {
     return [{ kind: "artifacts" }];
 }
@@ -32,27 +31,27 @@ function previewRequestBody(body) {
     }
     return Buffer.from(JSON.stringify(body), "utf8");
 }
-function requireCurrentArtifactManifestMarker(request, manifestBlobOid) {
-    const marker = new URL(request.url, "http://artifact.invalid").searchParams.get("v");
-    if (marker !== null && marker !== manifestBlobOid) {
-        throw new WorkspaceOpsError("not_found", "Artifact preview manifest is stale");
+function requireCurrentArtifactGeneration(request, previewGeneration) {
+    const marker = new URL(request.url, "http://artifact.invalid").searchParams.get("g");
+    if (marker !== previewGeneration) {
+        throw new WorkspaceOpsError("not_found", "Artifact preview generation is stale");
     }
 }
 export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
-    const artifactPreviewManager = new ArtifactPreviewManager({
-        ...options.artifactPreview,
-        ...(options.now === undefined ? {} : { now: options.now }),
-        onStatusChange: () => {
-            workspaceEvents.publish({
-                event_type: "query.invalidate",
-                payload: {
-                    reason: "bulk_state_change",
-                    message: "Artifacts changed.",
-                },
-                invalidates: artifactInvalidates(),
-            });
-        },
-    });
+    const artifactPreviewManager = options.artifactPreviewManager ??
+        new ArtifactPreviewManager({
+            ...options.artifactPreview,
+            onStatusChange: () => {
+                workspaceEvents.publish({
+                    event_type: "query.invalidate",
+                    payload: {
+                        reason: "bulk_state_change",
+                        message: "Artifacts changed.",
+                    },
+                    invalidates: artifactInvalidates(),
+                });
+            },
+        });
     app.addHook("onClose", async () => {
         await artifactPreviewManager.stopAll();
     });
@@ -68,6 +67,23 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
             workspaceRoot: requireWorkspaceRoot(options),
         });
     });
+    app.post(`${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/lease`, {
+        schema: {
+            response: {
+                204: { type: "null" },
+            },
+        },
+    }, (request, reply) => {
+        if (request.body !== undefined) {
+            throw new WorkspaceOpsError("bad_request", "Artifact preview lease does not accept a request body");
+        }
+        const session = requireHostProjectSession(request, options);
+        artifactPreviewManager.renewLease({
+            viewerId: session.client_session.client_session_id,
+            workspaceRoot: requireWorkspaceRoot(options),
+        });
+        void reply.code(204).send();
+    });
     app.all("/artifacts/preview/*", {
         bodyLimit: ARTIFACT_PREVIEW_REQUEST_BODY_LIMIT_BYTES,
     }, async (request, reply) => {
@@ -81,12 +97,9 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
             return;
         }
         const workspaceRoot = requireWorkspaceRoot(options);
-        const projection = readArtifactProjection({
-            workspaceRoot,
-            ...(options.now === undefined ? {} : { now: options.now }),
-        });
+        const projection = artifactPreviewManager.readProjection();
         if (projection.artifact.status === "declared") {
-            requireCurrentArtifactManifestMarker(request, projection.artifact.manifest_blob_oid);
+            requireCurrentArtifactGeneration(request, projection.artifact.preview_generation);
         }
         if (projection.artifact.status === "declared" &&
             projection.artifact.artifact.kind === "server") {
@@ -118,10 +131,11 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
                 .send("Static Artifact previews only support GET and HEAD");
             return;
         }
-        const preview = readArtifactStaticPreview({
+        const queryIndex = request.url.indexOf("?");
+        const preview = artifactPreviewManager.readStaticPreview({
             workspaceRoot,
             path: request.params["*"],
-            ...(options.now === undefined ? {} : { now: options.now }),
+            ...(queryIndex < 0 ? {} : { query: request.url.slice(queryIndex + 1) }),
         });
         void reply
             .header("content-type", preview.media_type)
@@ -130,86 +144,5 @@ export function registerArtifactsRoutes(app, { options, workspaceEvents, }) {
             .header("cache-control", "private, max-age=60")
             .send(preview.content);
     });
-    app.post(`${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/start`, {
-        schema: {
-            body: StartArtifactPreviewBodySchema,
-            response: {
-                200: StartArtifactPreviewResponseSchema,
-            },
-        },
-    }, (request) => {
-        requireHostProjectSession(request, options);
-        const store = requireProjectStore(options);
-        const invalidates = artifactInvalidates();
-        const execution = executeIdempotentCommand({
-            db: store.db,
-            command_id: request.body.command_id,
-            command_name: "artifacts.preview.start",
-            target_ref: "artifacts:active",
-            payload: request.body.payload,
-            ...(options.now === undefined ? {} : { now: options.now }),
-            execute: () => artifactPreviewManager.start({ workspaceRoot: requireWorkspaceRoot(options) }),
-        });
-        return {
-            command_id: execution.command_id,
-            disposition: execution.disposition,
-            ...(execution.result === undefined ? {} : { result: execution.result }),
-            invalidates,
-        };
-    });
-    app.post(`${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/heartbeat`, {
-        schema: {
-            body: HeartbeatArtifactPreviewBodySchema,
-            response: {
-                200: HeartbeatArtifactPreviewResponseSchema,
-            },
-        },
-    }, (request) => {
-        const session = requireHostProjectSession(request, options);
-        const store = requireProjectStore(options);
-        const invalidates = artifactInvalidates();
-        const execution = executeIdempotentCommand({
-            db: store.db,
-            command_id: request.body.command_id,
-            command_name: "artifacts.preview.heartbeat",
-            target_ref: `artifacts:active:${session.client_session.client_session_id}`,
-            payload: request.body.payload,
-            ...(options.now === undefined ? {} : { now: options.now }),
-            execute: () => artifactPreviewManager.heartbeat({ workspaceRoot: requireWorkspaceRoot(options) }),
-        });
-        return {
-            command_id: execution.command_id,
-            disposition: execution.disposition,
-            ...(execution.result === undefined ? {} : { result: execution.result }),
-            invalidates,
-        };
-    });
-    app.post(`${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/stop`, {
-        schema: {
-            body: StopArtifactPreviewBodySchema,
-            response: {
-                200: StopArtifactPreviewResponseSchema,
-            },
-        },
-    }, (request) => {
-        requireHostProjectSession(request, options);
-        const store = requireProjectStore(options);
-        const invalidates = artifactInvalidates();
-        const execution = executeIdempotentCommand({
-            db: store.db,
-            command_id: request.body.command_id,
-            command_name: "artifacts.preview.stop",
-            target_ref: "artifacts:active",
-            payload: request.body.payload,
-            ...(options.now === undefined ? {} : { now: options.now }),
-            execute: () => artifactPreviewManager.stop({ workspaceRoot: requireWorkspaceRoot(options) }),
-        });
-        return {
-            command_id: execution.command_id,
-            disposition: execution.disposition,
-            ...(execution.result === undefined ? {} : { result: execution.result }),
-            invalidates,
-        };
-    });
 }
 //# sourceMappingURL=artifacts-routes.js.map

package/dist/server-shell/http/routes/project-api/openapi-artifacts-routes.d.ts

@@ -11,41 +11,38 @@ export declare const HOST_PROJECT_ARTIFACTS_OPENAPI_ROUTES: ({
                     status: import("@sinclair/typebox").TLiteral<"not_declared">;
                 }>, import("@sinclair/typebox").TObject<{
                     status: import("@sinclair/typebox").TLiteral<"invalid">;
-                    manifest_path: import("@sinclair/typebox").TLiteral<"tutti.artifact.json">;
                     error: import("@sinclair/typebox").TObject<{
                         code: import("@sinclair/typebox").TString;
                         message: import("@sinclair/typebox").TString;
                     }>;
                 }>, import("@sinclair/typebox").TObject<{
                     status: import("@sinclair/typebox").TLiteral<"declared">;
-                    manifest_path: import("@sinclair/typebox").TLiteral<"tutti.artifact.json">;
-                    manifest_blob_oid: import("@sinclair/typebox").TString;
+                    preview_generation: import("@sinclair/typebox").TString;
                     artifact: import("@sinclair/typebox").TObject<{
                         title: import("@sinclair/typebox").TString;
                         kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"static">, import("@sinclair/typebox").TLiteral<"server">]>;
                         network: import("@sinclair/typebox").TBoolean;
                     }>;
                     preview: import("@sinclair/typebox").TObject<{
-                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"stopped">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"idle">, import("@sinclair/typebox").TLiteral<"failed">]>;
                         url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         error_message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     }>;
                 }>]>;
             }>;
         };
+        204?: never;
     };
-    requestBody?: never;
 } | {
     method: "post";
     path: string;
     summary: string;
     tags: string[];
-    requestBody: import("@sinclair/typebox").TSchema;
     responses: {
-        200: {
+        204: {
             description: string;
-            schema: import("@sinclair/typebox").TSchema;
         };
+        200?: never;
     };
 })[];
 //# sourceMappingURL=openapi-artifacts-routes.d.ts.map

package/dist/server-shell/http/routes/project-api/openapi-artifacts-routes.js

@@ -1,4 +1,4 @@
-import { GetArtifactsResponseSchema, HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewResponseSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewResponseSchema, } from "@tutti/shared/schemas/api";
+import { GetArtifactsResponseSchema, } from "@tutti/shared/schemas/api";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 export const HOST_PROJECT_ARTIFACTS_OPENAPI_ROUTES = [
     {
@@ -15,40 +15,12 @@ export const HOST_PROJECT_ARTIFACTS_OPENAPI_ROUTES = [
     },
     {
         method: "post",
-        path: `${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/start`,
-        summary: "Start or reuse the current server artifact preview.",
+        path: `${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/lease`,
+        summary: "Acquire or renew the current viewer's Artifact preview lease.",
         tags: ["artifacts"],
-        requestBody: StartArtifactPreviewBodySchema,
         responses: {
-            200: {
-                description: "Artifact preview start disposition.",
-                schema: StartArtifactPreviewResponseSchema,
-            },
-        },
-    },
-    {
-        method: "post",
-        path: `${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/heartbeat`,
-        summary: "Record a viewer lease heartbeat for the current artifact preview.",
-        tags: ["artifacts"],
-        requestBody: HeartbeatArtifactPreviewBodySchema,
-        responses: {
-            200: {
-                description: "Artifact preview heartbeat disposition.",
-                schema: HeartbeatArtifactPreviewResponseSchema,
-            },
-        },
-    },
-    {
-        method: "post",
-        path: `${HOST_PROJECT_API_BASE_PATH}/artifacts/preview/stop`,
-        summary: "Stop the current server artifact preview.",
-        tags: ["artifacts"],
-        requestBody: StopArtifactPreviewBodySchema,
-        responses: {
-            200: {
-                description: "Artifact preview stop disposition.",
-                schema: StopArtifactPreviewResponseSchema,
+            204: {
+                description: "Artifact preview lease renewed.",
             },
         },
     },

package/dist/server-shell/http/routes/project-api/openapi.d.ts

@@ -124,41 +124,38 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                     status: import("@sinclair/typebox").TLiteral<"not_declared">;
                 }>, import("@sinclair/typebox").TObject<{
                     status: import("@sinclair/typebox").TLiteral<"invalid">;
-                    manifest_path: import("@sinclair/typebox").TLiteral<"tutti.artifact.json">;
                     error: import("@sinclair/typebox").TObject<{
                         code: import("@sinclair/typebox").TString;
                         message: import("@sinclair/typebox").TString;
                     }>;
                 }>, import("@sinclair/typebox").TObject<{
                     status: import("@sinclair/typebox").TLiteral<"declared">;
-                    manifest_path: import("@sinclair/typebox").TLiteral<"tutti.artifact.json">;
-                    manifest_blob_oid: import("@sinclair/typebox").TString;
+                    preview_generation: import("@sinclair/typebox").TString;
                     artifact: import("@sinclair/typebox").TObject<{
                         title: import("@sinclair/typebox").TString;
                         kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"static">, import("@sinclair/typebox").TLiteral<"server">]>;
                         network: import("@sinclair/typebox").TBoolean;
                     }>;
                     preview: import("@sinclair/typebox").TObject<{
-                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"stopped">, import("@sinclair/typebox").TLiteral<"failed">]>;
+                        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"idle">, import("@sinclair/typebox").TLiteral<"failed">]>;
                         url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                         error_message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
                     }>;
                 }>]>;
             }>;
         };
+        204?: never;
     };
-    requestBody?: never;
 } | {
     method: "post";
     path: string;
     summary: string;
     tags: string[];
-    requestBody: import("@sinclair/typebox").TSchema;
     responses: {
-        200: {
+        204: {
             description: string;
-            schema: import("@sinclair/typebox").TSchema;
         };
+        200?: never;
     };
 } | {
     method: "get";
@@ -1867,6 +1864,18 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
         };
     };
     requestBody?: never;
+} | {
+    method: "post";
+    path: string;
+    summary: string;
+    tags: string[];
+    requestBody: import("@sinclair/typebox").TSchema;
+    responses: {
+        200: {
+            description: string;
+            schema: import("@sinclair/typebox").TSchema;
+        };
+    };
 } | {
     method: "get";
     path: string;

package/dist/server-shell/http/routes/project-api/types.d.ts

@@ -1,7 +1,7 @@
 import type { ReadOnlyChatAssistantHandle } from "../../../../chat-assistant/index.js";
 import type { Phase5ControlPlane } from "../../../../control-plane/index.js";
 import type { ApprovalRequestManager } from "../../../../approvals/index.js";
-import type { ArtifactPreviewManagerOptions } from "../../../../artifacts/index.js";
+import type { ArtifactPreviewManager, ArtifactPreviewManagerOptions } from "../../../../artifacts/index.js";
 import type { HostProjectStore } from "../../../../store/index.js";
 import type { ProjectId, RelayProjectRef } from "@tutti/shared/ids";
 import type { AccountAvatarProjection } from "@tutti/shared/domain";
@@ -73,7 +73,8 @@ export type HostProjectApiCapabilities = {
     clarification: boolean;
 };
 export type HostProjectApiRouteOptions = {
-    artifactPreview?: Omit<ArtifactPreviewManagerOptions, "now" | "onStatusChange">;
+    artifactPreview?: Omit<ArtifactPreviewManagerOptions, "onStatusChange">;
+    artifactPreviewManager?: ArtifactPreviewManager;
     project: {
         project_id: ProjectId;
         display_name: string;

package/dist/server-shell/local-console/invocation-context.d.ts

@@ -1,14 +1,21 @@
 export declare const LOCAL_CONSOLE_INVOCATION_ENV_KEYS: readonly ["DBUS_SESSION_BUS_ADDRESS", "DISPLAY", "LANG", "LC_ALL", "LC_CTYPE", "PATH", "TUTTI_HOST_ENDPOINT_HOST", "TUTTI_HOST_ENDPOINT_PORT", "TUTTI_RELAY_URL", "WAYLAND_DISPLAY", "XDG_CURRENT_DESKTOP"];
 export type LocalConsoleInvocationEnvironment = Partial<Record<(typeof LOCAL_CONSOLE_INVOCATION_ENV_KEYS)[number], string>>;
 export type LocalConsoleInvocationContext = {
+    source: "terminal";
     currentDirectory: string;
     environment: LocalConsoleInvocationEnvironment;
+} | {
+    source: "desktop";
+    environment: LocalConsoleInvocationEnvironment;
 };
 export declare function collectLocalConsoleInvocationEnvironment(env: NodeJS.ProcessEnv): LocalConsoleInvocationEnvironment;
 export declare function createLocalConsoleInvocationContext(options: {
     cwd: string;
     env: NodeJS.ProcessEnv;
 }): LocalConsoleInvocationContext;
+export declare function createDesktopLocalConsoleInvocationContext(options: {
+    env: NodeJS.ProcessEnv;
+}): LocalConsoleInvocationContext;
 export declare function createLocalConsoleServiceEnvironment(options: {
     env: NodeJS.ProcessEnv;
     tuttiHome: string;

package/dist/server-shell/local-console/invocation-context.js

@@ -24,21 +24,20 @@ export function collectLocalConsoleInvocationEnvironment(env) {
 }
 export function createLocalConsoleInvocationContext(options) {
     return {
+        source: "terminal",
         currentDirectory: resolve(options.cwd),
         environment: collectLocalConsoleInvocationEnvironment(options.env),
     };
 }
+export function createDesktopLocalConsoleInvocationContext(options) {
+    return {
+        source: "desktop",
+        environment: collectLocalConsoleInvocationEnvironment(options.env),
+    };
+}
 export function createLocalConsoleServiceEnvironment(options) {
     const environment = { TUTTI_HOME: options.tuttiHome };
-    for (const key of [
-        "HOME",
-        "LANG",
-        "LC_ALL",
-        "LC_CTYPE",
-        "LOGNAME",
-        "TMPDIR",
-        "USER",
-    ]) {
+    for (const key of ["HOME", "LANG", "LC_ALL", "LC_CTYPE", "LOGNAME", "TMPDIR", "USER"]) {
         const value = options.env[key];
         if (value !== undefined && value !== "") {
             environment[key] = value;

package/dist/server-shell/local-console/managed-console.d.ts

@@ -24,6 +24,7 @@ export declare function ensureLocalConsole(options?: {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
     fetchImpl?: FetchLike;
+    source?: "terminal" | "desktop";
 }): Promise<{
     url: string;
     endpoint: LocalConsoleRuntimeEndpoint;

package/dist/server-shell/local-console/managed-console.js

@@ -3,7 +3,7 @@ import { chmodSync, closeSync, existsSync, mkdirSync, openSync, renameSync, stat
 import { dirname, join, resolve } from "node:path";
 import { resolveTuttiHome } from "../../providers/openai/index.js";
 import { readCliVersion } from "../cli/version.js";
-import { createLocalConsoleInvocationContext, createLocalConsoleServiceEnvironment, } from "./invocation-context.js";
+import { createLocalConsoleInvocationContext, createDesktopLocalConsoleInvocationContext, createLocalConsoleServiceEnvironment, } from "./invocation-context.js";
 import { withLocalConsoleLifecycleLock } from "./lifecycle-lock.js";
 import { deleteLocalConsoleRuntimeEndpoint, readLocalConsoleRuntimeEndpoint, } from "./runtime-endpoint.js";
 import { LOCAL_CONSOLE_API_BASE } from "./server.js";
@@ -208,7 +208,6 @@ async function ensureConsoleEndpointUnlocked(options) {
     }
 }
 async function issueBrowserAccess(options) {
-    const context = createLocalConsoleInvocationContext({ cwd: options.cwd, env: options.env });
     const response = await options.fetchImpl(`${options.endpoint.base_url}${LOCAL_CONSOLE_API_BASE}/access-tokens`, {
         method: "POST",
         headers: {
@@ -217,8 +216,11 @@ async function issueBrowserAccess(options) {
             "content-type": "application/json",
         },
         body: JSON.stringify({
-            current_directory: context.currentDirectory,
-            environment: context.environment,
+            source: options.context.source,
+            ...(options.context.source === "terminal"
+                ? { current_directory: options.context.currentDirectory }
+                : {}),
+            environment: options.context.environment,
         }),
         signal: AbortSignal.timeout(3_000),
     });
@@ -240,9 +242,12 @@ export async function ensureLocalConsole(options = {}) {
         tuttiHome,
         run: async () => await ensureConsoleEndpointUnlocked({ cwd, env, tuttiHome, fetchImpl }),
     });
+    const context = options.source === "desktop"
+        ? createDesktopLocalConsoleInvocationContext({ env })
+        : createLocalConsoleInvocationContext({ cwd, env });
     return {
         endpoint,
-        url: await issueBrowserAccess({ endpoint, cwd, env, fetchImpl }),
+        url: await issueBrowserAccess({ endpoint, context, fetchImpl }),
     };
 }
 export async function readLocalConsoleServiceStatus(options = {}) {

package/dist/server-shell/local-console/project-service.js

@@ -164,7 +164,7 @@ export class LocalConsoleProjectService {
     }
     #operationOptions(context) {
         return {
-            cwd: context.currentDirectory,
+            cwd: context.source === "terminal" ? context.currentDirectory : this.#tuttiHome,
             env: createLocalConsoleOperationEnvironment({
                 serviceEnvironment: this.#serviceEnvironment,
                 invocationEnvironment: context.environment,

package/dist/server-shell/local-console/server.js

@@ -159,9 +159,10 @@ export function createLocalConsoleServer(options) {
         schema: {
             body: {
                 type: "object",
-                required: ["current_directory"],
+                required: ["source"],
                 additionalProperties: false,
                 properties: {
+                    source: { type: "string", enum: ["terminal", "desktop"] },
                     current_directory: { type: "string", minLength: 1, maxLength: 4096 },
                     environment: {
                         type: "object",
@@ -176,10 +177,21 @@ export function createLocalConsoleServer(options) {
         },
     }, (request) => {
         requireControl(request);
-        const access = sessions.issueAccessToken({
-            currentDirectory: resolve(request.body.current_directory),
-            environment: request.body.environment ?? {},
-        });
+        if ((request.body.source === "terminal" && request.body.current_directory === undefined) ||
+            (request.body.source === "desktop" && request.body.current_directory !== undefined)) {
+            throw new LocalConsoleHttpError(400, "bad_request", "Local Console invocation context is invalid.");
+        }
+        const context = request.body.source === "terminal"
+            ? {
+                source: "terminal",
+                currentDirectory: resolve(request.body.current_directory),
+                environment: request.body.environment ?? {},
+            }
+            : {
+                source: "desktop",
+                environment: request.body.environment ?? {},
+            };
+        const access = sessions.issueAccessToken(context);
         return { access_token: access.token, expires_at: access.expires_at };
     });
     app.post(`${LOCAL_CONSOLE_API_BASE}/session`, {
@@ -212,7 +224,12 @@ export function createLocalConsoleServer(options) {
         const session = requireSession(request);
         return {
             csrf_token: session.csrfToken,
-            current_directory: session.context.currentDirectory,
+            invocation: session.context.source === "terminal"
+                ? {
+                    source: "terminal",
+                    current_directory: session.context.currentDirectory,
+                }
+                : { source: "desktop" },
             platform: process.platform,
             folder_picker: detectLocalFolderPicker(process.platform, session.context.environment).kind,
         };