@vibesdotdev/terminal-client 0.0.0-stage → 1.0.0-rc.3

package/dist/tui/terminal.state-key.js

@@ -0,0 +1,9 @@
+/**
+ * The `terminal.registry` tui/state key: the execution places and opened
+ * sessions the terminal launcher shows, with the schema every value written
+ * to it is parsed by.
+ */
+import { defineTuiStateKey } from '@vibesdotdev/tui/kinds/tui-state';
+import { TerminalRegistryStateSchema } from "./terminal.state.js";
+export const terminalRegistryStateKey = defineTuiStateKey('terminal.registry', TerminalRegistryStateSchema);
+//# sourceMappingURL=terminal.state-key.js.map

package/dist/tui/terminal.state-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.state-key.js","sourceRoot":"","sources":["../../src/tui/terminal.state-key.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,mBAAmB,EAAE,2BAA2B,CAAC,CAAC"}

package/dist/tui/terminal.state.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Terminal-client TUI launcher — shared state shape + pure helpers.
+ *
+ * The `terminal.registry` tui/state holds the honest place catalog (where a
+ * terminal can be opened) and the sessions this launcher has opened. It is
+ * derived from the live runtime (`runtime/execution` providers + `fleet/host`
+ * descriptors), never hard-coded connection facts.
+ */
+import * as z from 'zod/v4';
+import { type ExecutionCapabilities } from '@vibesdotdev/kernel/execution';
+/** Coarse scope of an execution place — mirrors the control-plane matrix. */
+export declare const TerminalPlaceKindSchema: z.ZodEnum<{
+    cloud: "cloud";
+    device: "device";
+    fleet: "fleet";
+}>;
+export type TerminalPlaceKind = z.infer<typeof TerminalPlaceKindSchema>;
+/**
+ * Availability is truthful (D-HONEST-CAPS):
+ * - `available`   — a real execution provider (or reachable host) backs it now.
+ * - `unconfigured` — the place archetype is understood but nothing is wired here
+ *                    yet (e.g. no paired fleet host, no cloud exec provider).
+ * - `unavailable` — a provider exists but failed its reachability probe.
+ */
+export declare const TerminalPlaceAvailabilitySchema: z.ZodEnum<{
+    unavailable: "unavailable";
+    available: "available";
+    unconfigured: "unconfigured";
+}>;
+export type TerminalPlaceAvailability = z.infer<typeof TerminalPlaceAvailabilitySchema>;
+export declare const TerminalPlaceViewSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        cloud: "cloud";
+        device: "device";
+        fleet: "fleet";
+    }>;
+    label: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodObject<{
+        pty: z.ZodBoolean;
+        shell: z.ZodBoolean;
+        signals: z.ZodBoolean;
+        resize: z.ZodBoolean;
+        maxSessions: z.ZodNumber;
+    }, z.core.$strict>;
+    availability: z.ZodEnum<{
+        unavailable: "unavailable";
+        available: "available";
+        unconfigured: "unconfigured";
+    }>;
+    detail: z.ZodString;
+}, z.core.$strip>;
+export type TerminalPlaceView = z.infer<typeof TerminalPlaceViewSchema>;
+/**
+ * Session outcomes are truthful (D-HONEST-CAPS):
+ * - `live`    — an interactive session is open.
+ * - `ran`     — a command actually executed and returned.
+ * - `exited`  — a previously-live session ended.
+ * - `error`   — the launch/command failed.
+ * - `handoff` — nothing ran here; control was handed to another surface (e.g. a
+ *   fleet place opens its remote PTY in the terminal surface). Never implies a
+ *   shell ran.
+ */
+export declare const TerminalSessionStatusSchema: z.ZodEnum<{
+    error: "error";
+    live: "live";
+    exited: "exited";
+    ran: "ran";
+    handoff: "handoff";
+}>;
+export type TerminalSessionStatus = z.infer<typeof TerminalSessionStatusSchema>;
+export declare const TerminalSessionViewSchema: z.ZodObject<{
+    id: z.ZodString;
+    placeId: z.ZodString;
+    placeLabel: z.ZodString;
+    command: z.ZodString;
+    status: z.ZodEnum<{
+        error: "error";
+        live: "live";
+        exited: "exited";
+        ran: "ran";
+        handoff: "handoff";
+    }>;
+    openedAt: z.ZodString;
+    note: z.ZodString;
+}, z.core.$strip>;
+export type TerminalSessionView = z.infer<typeof TerminalSessionViewSchema>;
+/** The `terminal.registry` tui/state value; its key parses every write with this. */
+export declare const TerminalRegistryStateSchema: z.ZodObject<{
+    places: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            cloud: "cloud";
+            device: "device";
+            fleet: "fleet";
+        }>;
+        label: z.ZodString;
+        executionId: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodObject<{
+            pty: z.ZodBoolean;
+            shell: z.ZodBoolean;
+            signals: z.ZodBoolean;
+            resize: z.ZodBoolean;
+            maxSessions: z.ZodNumber;
+        }, z.core.$strict>;
+        availability: z.ZodEnum<{
+            unavailable: "unavailable";
+            available: "available";
+            unconfigured: "unconfigured";
+        }>;
+        detail: z.ZodString;
+    }, z.core.$strip>>;
+    sessions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        placeId: z.ZodString;
+        placeLabel: z.ZodString;
+        command: z.ZodString;
+        status: z.ZodEnum<{
+            error: "error";
+            live: "live";
+            exited: "exited";
+            ran: "ran";
+            handoff: "handoff";
+        }>;
+        openedAt: z.ZodString;
+        note: z.ZodString;
+    }, z.core.$strip>>;
+    loaded: z.ZodBoolean;
+    loading: z.ZodBoolean;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type TerminalRegistryState = z.infer<typeof TerminalRegistryStateSchema>;
+export declare const defaultTerminalRegistryState: TerminalRegistryState;
+/** Default capability expectation for a place before it resolves an impl. */
+export declare function terminalPlaceDefaultCapabilities(kind: TerminalPlaceKind): ExecutionCapabilities;
+/**
+ * Honest capability banner. Interactive (`pty:true`) places return `null` — no
+ * banner needed. Non-PTY places state plainly that commands run and return
+ * their output, with no faked "live" keystroke stream.
+ */
+export declare function terminalPlaceCapabilityBanner(place: TerminalPlaceView): string | null;
+/** Compact capability summary for a list row. */
+export declare function terminalCapabilitySummary(caps: ExecutionCapabilities): string;
+export declare function terminalPlaceAvailabilityLabel(availability: TerminalPlaceAvailability): string;
+/**
+ * Human label for a session outcome. `handoff` reads as "handoff" — never as a
+ * command/shell that ran (D-HONEST-CAPS).
+ */
+export declare function terminalSessionStatusLabel(status: TerminalSessionStatus): string;
+export declare function sortTerminalPlaces(places: TerminalPlaceView[]): TerminalPlaceView[];
+//# sourceMappingURL=terminal.state.d.ts.map

package/dist/tui/terminal.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.state.d.ts","sourceRoot":"","sources":["../../src/tui/terminal.state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAA+B,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAExG,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB;;;;EAAuC,CAAC;AAC5E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;;;EAAuD,CAAC;AACpG,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;iBAYlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B;;;;;;EAAwD,CAAC;AACjG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;iBASpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,qFAAqF;AACrF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,4BAA4B,EAAE,qBAM1C,CAAC;AAkBF,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,CAE/F;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAGrF;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAM7E;AAED,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,yBAAyB,GAAG,MAAM,CAI9F;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAahF;AAUD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAQnF"}

package/dist/tui/terminal.state.js

@@ -0,0 +1,149 @@
+/**
+ * Terminal-client TUI launcher — shared state shape + pure helpers.
+ *
+ * The `terminal.registry` tui/state holds the honest place catalog (where a
+ * terminal can be opened) and the sessions this launcher has opened. It is
+ * derived from the live runtime (`runtime/execution` providers + `fleet/host`
+ * descriptors), never hard-coded connection facts.
+ */
+import * as z from 'zod/v4';
+import { ExecutionCapabilitiesSchema } from '@vibesdotdev/kernel/execution';
+/** Coarse scope of an execution place — mirrors the control-plane matrix. */
+export const TerminalPlaceKindSchema = z.enum(['device', 'fleet', 'cloud']);
+/**
+ * Availability is truthful (D-HONEST-CAPS):
+ * - `available`   — a real execution provider (or reachable host) backs it now.
+ * - `unconfigured` — the place archetype is understood but nothing is wired here
+ *                    yet (e.g. no paired fleet host, no cloud exec provider).
+ * - `unavailable` — a provider exists but failed its reachability probe.
+ */
+export const TerminalPlaceAvailabilitySchema = z.enum(['available', 'unconfigured', 'unavailable']);
+export const TerminalPlaceViewSchema = z.object({
+    /** Place selector, e.g. `device:local`, `fleet:<hostId>`, `cloud:exec`. */
+    id: z.string(),
+    kind: TerminalPlaceKindSchema,
+    label: z.string(),
+    /** Execution provider id to resolve when opening here (when known). */
+    executionId: z.string().optional(),
+    /** Honest capability mask advertised for this place. */
+    capabilities: ExecutionCapabilitiesSchema,
+    availability: TerminalPlaceAvailabilitySchema,
+    /** One-line honest description shown in the detail pane. */
+    detail: z.string()
+});
+/**
+ * Session outcomes are truthful (D-HONEST-CAPS):
+ * - `live`    — an interactive session is open.
+ * - `ran`     — a command actually executed and returned.
+ * - `exited`  — a previously-live session ended.
+ * - `error`   — the launch/command failed.
+ * - `handoff` — nothing ran here; control was handed to another surface (e.g. a
+ *   fleet place opens its remote PTY in the terminal surface). Never implies a
+ *   shell ran.
+ */
+export const TerminalSessionStatusSchema = z.enum(['live', 'ran', 'exited', 'error', 'handoff']);
+export const TerminalSessionViewSchema = z.object({
+    id: z.string(),
+    placeId: z.string(),
+    placeLabel: z.string(),
+    command: z.string(),
+    status: TerminalSessionStatusSchema,
+    openedAt: z.string(),
+    /** Short outcome note (exit code, first output line, or error). */
+    note: z.string()
+});
+/** The `terminal.registry` tui/state value; its key parses every write with this. */
+export const TerminalRegistryStateSchema = z.object({
+    places: z.array(TerminalPlaceViewSchema),
+    sessions: z.array(TerminalSessionViewSchema),
+    loaded: z.boolean(),
+    loading: z.boolean(),
+    error: z.string().nullable()
+});
+export const defaultTerminalRegistryState = {
+    places: [],
+    sessions: [],
+    loaded: false,
+    loading: true,
+    error: null
+};
+const PTY_CAPS = {
+    pty: true,
+    shell: true,
+    signals: true,
+    resize: true,
+    maxSessions: 1
+};
+const EXEC_ONLY_CAPS = {
+    pty: false,
+    shell: true,
+    signals: false,
+    resize: false,
+    maxSessions: 8
+};
+/** Default capability expectation for a place before it resolves an impl. */
+export function terminalPlaceDefaultCapabilities(kind) {
+    return kind === 'cloud' ? { ...EXEC_ONLY_CAPS } : { ...PTY_CAPS };
+}
+/**
+ * Honest capability banner. Interactive (`pty:true`) places return `null` — no
+ * banner needed. Non-PTY places state plainly that commands run and return
+ * their output, with no faked "live" keystroke stream.
+ */
+export function terminalPlaceCapabilityBanner(place) {
+    if (place.capabilities.pty)
+        return null;
+    return `${place.label} — no live keystrokes here. Commands run and return their output.`;
+}
+/** Compact capability summary for a list row. */
+export function terminalCapabilitySummary(caps) {
+    const mode = caps.pty ? 'interactive PTY' : 'exec-only';
+    const verbs = [caps.shell && 'shell', caps.signals && 'signals', caps.resize && 'resize']
+        .filter(Boolean)
+        .join(' · ');
+    return verbs ? `${mode} · ${verbs}` : mode;
+}
+export function terminalPlaceAvailabilityLabel(availability) {
+    if (availability === 'available')
+        return 'Ready';
+    if (availability === 'unavailable')
+        return 'Unreachable';
+    return 'Not configured';
+}
+/**
+ * Human label for a session outcome. `handoff` reads as "handoff" — never as a
+ * command/shell that ran (D-HONEST-CAPS).
+ */
+export function terminalSessionStatusLabel(status) {
+    switch (status) {
+        case 'live':
+            return 'live';
+        case 'ran':
+            return 'ran';
+        case 'exited':
+            return 'exited';
+        case 'error':
+            return 'error';
+        case 'handoff':
+            return 'handoff';
+    }
+}
+/** Stable sort: available places first, then by kind (device→fleet→cloud). */
+const KIND_ORDER = { device: 0, fleet: 1, cloud: 2 };
+const AVAIL_ORDER = {
+    available: 0,
+    unconfigured: 1,
+    unavailable: 2
+};
+export function sortTerminalPlaces(places) {
+    return [...places].sort((a, b) => {
+        const byAvail = AVAIL_ORDER[a.availability] - AVAIL_ORDER[b.availability];
+        if (byAvail !== 0)
+            return byAvail;
+        const byKind = KIND_ORDER[a.kind] - KIND_ORDER[b.kind];
+        if (byKind !== 0)
+            return byKind;
+        return a.label.localeCompare(b.label);
+    });
+}
+//# sourceMappingURL=terminal.state.js.map

package/dist/tui/terminal.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.state.js","sourceRoot":"","sources":["../../src/tui/terminal.state.ts"],"names":[],"mappings":"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"}

package/dist/workspace.d.ts

@@ -0,0 +1,155 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ExecutionCapabilities, ExecutionSession, ProcessHandle, RuntimeExecution } from '@vibesdotdev/kernel/execution';
+import * as z from 'zod/v4';
+export declare const terminalWorkspaceVesselStateSchema: z.ZodObject<{
+    executionId: z.ZodDefault<z.ZodString>;
+    cwd: z.ZodDefault<z.ZodString>;
+    correlationId: z.ZodOptional<z.ZodString>;
+    sourceSurfaceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TerminalWorkspaceStatus = 'idle' | 'opening' | 'live' | 'exited' | 'error';
+export interface TerminalWorkspaceRuntimePlaceOption {
+    id: string;
+    label: string;
+    status: 'available' | 'unavailable';
+    detail?: string;
+    /** Explicit local execution selector when a place has more than one provider. */
+    executionId?: string;
+    /**
+     * Honest capability mask this place advertises. Surfaces gate UI on it
+     * (D-HONEST-CAPS): `pty:false` places render an exec banner, never a live
+     * keystroke terminal. Omitted → derived from the place id.
+     */
+    capabilities?: ExecutionCapabilities;
+}
+export type TerminalWorkspaceQuickActionId = 'help' | 'clear' | 'interrupt' | 'end';
+export interface TerminalWorkspaceQuickAction {
+    id: TerminalWorkspaceQuickActionId;
+    label: string;
+    description: string;
+    command?: string;
+    signal?: string;
+}
+export interface TerminalWorkspaceOpenedReceipt {
+    phase: 'opened';
+    sessionId: string;
+    environmentId: string;
+    executionId: string;
+    runtimePlaceId: string;
+    cwd: string;
+    openedAt: string;
+}
+export interface TerminalWorkspaceExitedEvent {
+    phase: 'exited';
+    sessionId: string;
+    environmentId: string;
+    executionId: string;
+    runtimePlaceId: string;
+    cwd: string;
+    openedAt: string;
+    exitedAt: string;
+    exitCode: number | null;
+}
+/**
+ * Actual Terminal lifecycle outcomes. `opened` is the only success receipt and
+ * is produced only after `runtime/execution.session()` resolves.
+ */
+export type TerminalWorkspaceLifecycleEvent = TerminalWorkspaceOpenedReceipt | TerminalWorkspaceExitedEvent;
+export interface OpenTerminalWorkspaceSessionInput {
+    execution: Pick<RuntimeExecution, 'id' | 'resolveCommand' | 'session'>;
+    /**
+     * The session's whole environment, run with `envMode: 'replace'`: this
+     * host's composed environment for a native session, and nothing for a
+     * provider that runs children in its own environment (the browser shell).
+     */
+    env: Record<string, string>;
+    command: string;
+    args?: string[];
+    runtimePlaceId: string;
+    cwd: string;
+    cols: number;
+    rows: number;
+    now?: () => Date;
+}
+export interface OpenTerminalWorkspaceSessionResult {
+    session: ExecutionSession;
+    receipt: TerminalWorkspaceOpenedReceipt;
+}
+export type TerminalWorkspaceSessionMode = 'session' | 'exec';
+/**
+ * Outcome of opening the authority named by a place selector.
+ *
+ * `mode:'session'` is the interactive PTY path — `session` is a live
+ * `ExecutionSession`. `mode:'exec'` is the honest non-PTY path (e.g. cloud):
+ * there is NO interactive PTY session (`session:null`), but output STREAMS live
+ * — `execProcess` is a `ProcessHandle` whose stdout/stderr the surface drains as
+ * bytes arrive. No keystroke stream is faked. `capabilities` is the live mask of
+ * the resolved execution so the surface can gate its UI truthfully.
+ */
+export interface OpenTerminalWorkspaceTargetSessionResult {
+    session: ExecutionSession | null;
+    receipt: TerminalWorkspaceOpenedReceipt;
+    capabilities: ExecutionCapabilities;
+    mode: TerminalWorkspaceSessionMode;
+    /** Live streaming process for exec-mode, present only when `mode:'exec'`. */
+    execProcess?: ProcessHandle;
+}
+export interface OpenTerminalWorkspaceTargetSessionInput {
+    runtime: VibesRuntime;
+    executionId: string;
+    command: string;
+    args?: string[];
+    runtimePlaceId: string;
+    cwd: string;
+    cols: number;
+    rows: number;
+    now?: () => Date;
+}
+export interface TerminalWorkspaceLaunchInput {
+    executionId: string;
+    runtimePlaceId: string;
+    command: string;
+    args?: readonly string[];
+    cwd: string;
+}
+/** Stable identity for every prop that selects or configures a live session. */
+export declare function terminalWorkspaceLaunchSignature(input: TerminalWorkspaceLaunchInput): string;
+export declare function terminalWorkspaceDefaultCommand(runtimePlaceId: string): string;
+export declare const terminalWorkspaceQuickActions: readonly TerminalWorkspaceQuickAction[];
+/**
+ * Resolve and open the real execution session, then derive its success receipt.
+ * The clock is read after the awaited session resolves, so callers cannot
+ * observe an `opened` receipt for a request the execution provider has not
+ * accepted.
+ */
+export declare function openTerminalWorkspaceSession(input: OpenTerminalWorkspaceSessionInput): Promise<OpenTerminalWorkspaceSessionResult>;
+/**
+ * Open against the authority named by this window's immutable place selector.
+ * Browser, local-machine, and fleet paths stay explicit so a remote label can
+ * never silently fall back to a local browser shell.
+ */
+export declare function openTerminalWorkspaceTargetSession(input: OpenTerminalWorkspaceTargetSessionInput): Promise<OpenTerminalWorkspaceTargetSessionResult>;
+/**
+ * Pre-resolution capability expectation for a place, used only to gate the UI
+ * before the impl is resolved. `cloud:`/`sandbox:` are now interactive
+ * (D-NO-DEFER / A5): a REAL PTY runs inside the CF Sandbox container via the
+ * pty-ws server, so `pty:true`. The live mask from `getCapabilities()` overrides
+ * this once a place is opened.
+ */
+export declare function terminalWorkspacePlaceDefaultCapabilities(runtimePlaceId: string): ExecutionCapabilities;
+/**
+ * Banner copy for a place. Non-PTY places get the honest "streams output live,
+ * no interactive TTY" caveat. Interactive cloud/sandbox places get a short
+ * positive note ("cloud PTY (containerized)") — the PTY is real, it just lives
+ * in the sandbox container, so there is no caveat, only context. Interactive
+ * local/device/fleet places get no banner (`null`). No jargon; no overclaim.
+ */
+export declare function terminalWorkspaceCapabilityBanner(capabilities: Pick<ExecutionCapabilities, 'pty'>, runtimePlaceId: string): string | null;
+export declare function terminalWorkspaceExitedEvent(receipt: TerminalWorkspaceOpenedReceipt, result: {
+    exitCode: number | null;
+}, now?: () => Date): TerminalWorkspaceExitedEvent;
+export declare function terminalWorkspaceStatusLabel(status: TerminalWorkspaceStatus): string;
+export declare function terminalWorkspacePlaceLabel(runtimePlaceId: string): string;
+export declare function terminalWorkspaceConnectionNotice(cwd: string, runtimePlaceId: string): string;
+export declare function terminalWorkspaceError<Failure>(_error: Failure, runtimePlaceId?: string): string;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"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"}