@fresh-editor/fresh-editor 0.3.7 → 0.3.8

package/plugins/lib/fresh.d.ts

@@ -621,6 +621,50 @@ type TerminalResult = {
 	*/
 	splitId: number | null;
 };
+type CreateWindowWithTerminalOptions = {
+	/**
+	* Absolute path to the new session's worktree / project
+	* root. Relative paths are rejected (logged, no window
+	* created).
+	*/
+	root: string;
+	/**
+	* Human-readable label for the new session. When empty,
+	* defaults to the basename of `root`.
+	*/
+	label: string;
+	/**
+	* Working directory for the spawned terminal. Defaults to
+	* `root` when omitted.
+	*/
+	cwd?: string;
+	/**
+	* Argv to spawn directly inside the PTY. `None` keeps the
+	* shell-and-type behaviour; `Some([cmd, ...args])` runs the
+	* command as the PTY child (used by Orchestrator so the
+	* agent process is the PTY's direct child).
+	*/
+	command?: Array<string>;
+	/**
+	* Tab title override. Defaults to `command[0]`'s basename
+	* when `command` is set, or "Terminal N" otherwise.
+	*/
+	title?: string;
+};
+type SessionWithTerminalResult = {
+	/**
+	* The new window's id.
+	*/
+	windowId: number;
+	/**
+	* The seeded terminal's id (for `sendTerminalInput`, etc.).
+	*/
+	terminalId: number;
+	/**
+	* The seeded terminal buffer's id.
+	*/
+	bufferId: number;
+};
 type CreateTerminalOptions = {
 	/**
 	* Working directory for the terminal (defaults to editor cwd)
@@ -722,6 +766,13 @@ type OverlayOptions = {
 	*/
 	extendToLineEnd: boolean;
 	/**
+	* When `true`, `fg` is applied only on cells whose existing fg
+	* matches this overlay's resolved bg — i.e. a same-colour fg/bg
+	* collision. Lets a row-wide overlay stay legible on tokens that
+	* share the bg's colour without repainting unrelated tokens.
+	*/
+	fgOnCollisionOnly: boolean;
+	/**
 	* Optional URL for OSC 8 terminal hyperlinks.
 	* When set, the overlay text becomes a clickable hyperlink in terminals
 	* that support OSC 8 escape sequences.
@@ -1006,7 +1057,7 @@ type WidgetSpec = {
 	* `WidgetMutation::SetCompletions`. An empty `items`
 	* closes the popup.
 	*/
-	completions?: Array<string>;
+	completions?: Array<string | CompletionItem>;
 	/**
 	* How many candidate rows the popup paints at once
 	* when it opens. Excess candidates stay reachable
@@ -1091,7 +1142,7 @@ type WidgetMutation = {
 } | {
 	"kind": "setCompletions";
 	widgetKey: string;
-	items: Array<string>;
+	items: Array<string | CompletionItem>;
 } | {
 	"kind": "setChecked";
 	widgetKey: string;
@@ -1813,6 +1864,41 @@ interface EditorAPI {
 	*/
 	getAuthorityLabel(): string;
 	/**
+	* Current Workspace Trust level for the active project:
+	* `"restricted"`, `"trusted"`, or `"blocked"` (empty `""` when trust
+	* state is unavailable, e.g. the default local authority).
+	*
+	* Trust is a per-project, user-granted decision. Plugins that run
+	* repo-controlled work (env activation, project tooling, repo-local
+	* binaries) MUST gate on this and treat anything other than
+	* `"trusted"` as "do not execute".
+	*/
+	workspaceTrustLevel(): "restricted" | "trusted" | "blocked" | "";
+	/**
+	* Activate an environment by setting the live env recipe: an activation
+	* shell `snippet` (e.g. `eval "$(direnv export bash)"`,
+	* `source .venv/bin/activate`, or `""` for a pure login shell) run in
+	* `dir` (defaults to the workspace). It is re-evaluated on demand on the
+	* active backend and applied to every spawn — language servers,
+	* formatters, `spawnProcess` — so they see the project environment. No
+	* authority rebuild; the LSP is restarted to pick it up.
+	*
+	* Honored only when `workspaceTrustLevel() === "trusted"` (it runs
+	* repo-controlled code). Call `clearEnv()` to deactivate.
+	*/
+	setEnv(snippet: string, dir?: string): void;
+	/**
+	* Deactivate the environment set by `setEnv` — spawns return to the
+	* inherited environment.
+	*/
+	clearEnv(): void;
+	/**
+	* Whether an environment is currently active (a recipe was set via
+	* `setEnv`). Survives the restart `setEnv` triggers, so a plugin can
+	* re-establish its file watch and reflect activation after reloading.
+	*/
+	envActive(): boolean;
+	/**
 	* Join path components (variadic - accepts multiple string arguments)
 	* Always uses forward slashes for cross-platform consistency (like Node.js path.posix.join)
 	* 
@@ -2799,6 +2885,19 @@ interface EditorAPI {
 	*/
 	clearRemoteIndicatorState(): void;
 	/**
+	* Fetch a URL over HTTP(S) and stream the response body into `target_path`.
+	* 
+	* Resolves with a `SpawnResult`-shaped value: `exit_code` is `0` on a
+	* 2xx response (file written), the HTTP status code on non-2xx
+	* (target file untouched), and `-1` on transport errors. `stderr`
+	* carries an error message in the non-success cases; `stdout` is
+	* always empty.
+	* 
+	* This uses the editor's built-in HTTP client (`ureq`), so plugins
+	* don't need `curl`/`wget` on PATH.
+	*/
+	httpFetch(url: string, targetPath: string): ProcessHandle<SpawnResult>;
+	/**
 	* Wait for a process to complete and get its result (async)
 	*/
 	spawnProcessWait(processId: number): Promise<SpawnResult>;
@@ -2851,6 +2950,14 @@ interface EditorAPI {
 	*/
 	createTerminal(opts?: CreateTerminalOptions): Promise<TerminalResult>;
 	/**
+	* Create a new editor window seeded with an agent terminal as
+	* its only buffer. Atomic — replaces the legacy
+	* `createWindow` + `setActiveWindow` + `createTerminal`
+	* chain that left a transient `[No Name]` tab alongside the
+	* agent terminal.
+	*/
+	createWindowWithTerminal(opts: CreateWindowWithTerminalOptions): Promise<SessionWithTerminalResult>;
+	/**
 	* Send input data to a terminal
 	*/
 	sendTerminalInput(terminalId: number, data: string): boolean;

package/plugins/live_diff.ts

@@ -38,19 +38,18 @@ const PRIORITY = 9;
 
 // Theme keys for backgrounds and "on top of bg" foregrounds. These
 // are resolved at render time by the editor, so the diff colors track
-// the active theme automatically. The `editor.diff_*_fg` keys are
-// purpose-built for "text drawn on top of the matching diff bg" —
-// they default to `ui.file_status_*_fg` so themes that haven't been
-// updated still work, but themes whose `file_status_*_fg` collides
-// with `diff_*_bg` (e.g. `terminal`, where both resolve to ANSI Red)
-// override `editor.diff_*_fg` to a contrasting color.
+// the active theme automatically. The `editor.diff_*_collision_fg`
+// keys pair with `fgOnCollisionOnly: true` below: themes that define
+// them get a contrasting fg painted only on cells whose syntax fg
+// happens to match the diff bg (e.g. ANSI Green-on-Green); every
+// other cell keeps its syntax colour.
 const THEME = {
   addedBg: "editor.diff_add_bg",
-  addedFg: "editor.diff_add_fg",
+  addedFg: "editor.diff_add_collision_fg",
   modifiedBg: "editor.diff_modify_bg",
-  modifiedFg: "editor.diff_modify_fg",
+  modifiedFg: "editor.diff_modify_collision_fg",
   removedBg: "editor.diff_remove_bg",
-  removedFg: "editor.diff_remove_fg",
+  removedFg: "editor.diff_remove_collision_fg",
 };
 
 // `setLineIndicator` only accepts RGB triples (not theme keys), so the
@@ -845,14 +844,9 @@ function renderHunks(state: BufferDiffState, newLines: string[]): void {
   for (const h of state.hunks) {
     if (h.kind === "added" || h.kind === "modified") {
       const bg = h.kind === "added" ? THEME.addedBg : THEME.modifiedBg;
-      // Passing `fg` as a theme key lets each theme decide whether to
-      // override the cell's existing fg: themes that DEFINE
-      // `editor.diff_*_fg` (e.g. `terminal`, where the ANSI bg would
-      // otherwise collide with same-named syntax colors) get a
-      // contrasting fg painted on; themes that don't define the key
-      // resolve to `None` in `OverlayFace::ThemedStyle`, so the
-      // overlay leaves the cell's fg alone and syntax highlighting
-      // shows through unchanged.
+      // `fgOnCollisionOnly` keeps syntax highlighting intact on the
+      // rest of the line and only paints `fg` where a token's colour
+      // would otherwise be invisible against the diff bg.
       const fg = h.kind === "added" ? THEME.addedFg : THEME.modifiedFg;
       for (let i = 0; i < h.newCount; i++) {
         const line = h.newStart + i;
@@ -871,6 +865,7 @@ function renderHunks(state: BufferDiffState, newLines: string[]): void {
         editor.addOverlay(bid, NS_OVERLAY, start, end, {
           bg,
           fg,
+          fgOnCollisionOnly: true,
           underline: false,
           bold: false,
           italic: false,