@aexol/spectral 0.6.8 → 0.7.0

package/dist/cli.js

@@ -136,15 +136,19 @@ function printHeader() {
 // ---- Delegate to pi ----------------------------------------------------------
 function delegateToPi(args) {
     const piBin = resolvePiBin();
+    // The subprocess inherits a snapshot of process.env (which already has
+    // all interactive-editor vars disabled by disableInteractiveGitEditors()),
+    // but we pass it explicitly anyway as defense-in-depth in case the user
+    // overrides any of these in their shell rc files before launching spectral.
     const child = spawn(process.execPath, [piBin, ...args], {
         stdio: "inherit",
         env: {
             ...process.env,
-            // Prevent git from opening an interactive editor when the agent
-            // runs commands like `git rebase --continue`, `git commit` (without -m),
-            // or `git merge`. Without this, the editor hangs forever waiting for
-            // TTY input that doesn't exist in the agent's non-interactive shell.
             GIT_EDITOR: "true",
+            GIT_SEQUENCE_EDITOR: "true",
+            EDITOR: "true",
+            VISUAL: "true",
+            GIT_PAGER: "cat",
         },
     });
     // Forward common termination signals to pi so its TUI can clean up.
@@ -177,8 +181,32 @@ function delegateToPi(args) {
     // TypeScript needs a `never` terminator.
     return undefined;
 }
+// ---- Disable interactive git editors ----------------------------------------
+// Set at process level so BOTH direct mode (delegateToPi → subprocess inherits)
+// AND serve mode (PiBridge in-process → getShellEnv() returns process.env) are
+// covered. Without this, `git rebase --continue`, `git commit` (without -m),
+// `git merge`, etc. open an editor that hangs forever — the agent's bash tool
+// runs with `stdio: ["ignore", ...]`, so there is no TTY to interact with.
+function disableInteractiveGitEditors() {
+    const editorVars = {
+        GIT_EDITOR: "true",
+        GIT_SEQUENCE_EDITOR: "true",
+        EDITOR: "true",
+        VISUAL: "true",
+        // cat pipes output straight through; prevents git's pager (less) from
+        // blocking on a non-existent TTY.
+        GIT_PAGER: "cat",
+    };
+    for (const [key, value] of Object.entries(editorVars)) {
+        if (!process.env[key]) {
+            process.env[key] = value;
+        }
+    }
+}
 // ---- Main --------------------------------------------------------------------
 async function main() {
+    // Must be called before any pi process is spawned (direct or serve).
+    disableInteractiveGitEditors();
     const args = process.argv.slice(2);
     const first = args[0];
     // Branded short-circuits: never require login.

package/dist/extensions/aexol-mcp.js

@@ -45,8 +45,23 @@ function renderContentToString(content) {
     }
     if (typeof first.text === "string")
         return first.text;
+    // For image/audio/binary content types, return a metadata placeholder
+    // instead of serializing the raw base64 data into the model context.
+    if (first.type === "image" || first.type === "audio") {
+        const mimeType = typeof first.mimeType === "string" ? first.mimeType : first.type;
+        const dataLen = typeof first.data === "string" ? first.data.length : 0;
+        return `[${first.type}: ${mimeType}${dataLen ? `, ${dataLen.toLocaleString()} bytes base64` : ""}]`;
+    }
     try {
-        return JSON.stringify(content, null, 2);
+        // Strip large binary fields from serialization to prevent context overflow.
+        const safe = content.map((c) => {
+            const copy = { ...c };
+            if ("data" in copy && typeof copy.data === "string" && copy.data.length > 200) {
+                copy.data = `[${copy.data.length.toLocaleString()} bytes base64 omitted]`;
+            }
+            return copy;
+        });
+        return JSON.stringify(safe, null, 2);
     }
     catch {
         return String(content);

package/dist/mcp/tool-registrar.js

@@ -57,7 +57,14 @@ export function transformMcpContent(content) {
         }
         if (c.type === "resource") {
             const resourceUri = c.resource?.uri ?? "(no URI)";
-            const resourceContent = c.resource?.text ?? (c.resource ? JSON.stringify(c.resource) : "(no content)");
+            // Blob resources contain base64 binary data — never serialize the raw
+            // blob into the model context (causes context overflow and dead sessions).
+            const resourceContent = c.resource?.text ??
+                ("blob" in (c.resource ?? {}) && c.resource.blob
+                    ? `[Binary blob: ${c.resource.mimeType ?? "application/octet-stream"}]`
+                    : c.resource
+                        ? JSON.stringify(c.resource)
+                        : "(no content)");
             return truncateTextBlock({
                 type: "text",
                 text: `[Resource: ${resourceUri}]\n${resourceContent}`,
@@ -77,6 +84,15 @@ export function transformMcpContent(content) {
                 text: `[Audio content: ${c.mimeType ?? "audio/*"}]`,
             };
         }
-        return truncateTextBlock({ type: "text", text: JSON.stringify(c) });
+        // Unknown content type — serialize as text but strip any potentially
+        // large binary fields (data, blob) to avoid context overflow.
+        const safe = { ...c };
+        if ("data" in safe && typeof safe.data === "string" && safe.data.length > 200) {
+            safe.data = `[${safe.data.length.toLocaleString()} bytes base64 omitted]`;
+        }
+        if ("blob" in safe && typeof safe.blob === "string" && safe.blob.length > 200) {
+            safe.blob = `[${safe.blob.length.toLocaleString()} bytes base64 omitted]`;
+        }
+        return truncateTextBlock({ type: "text", text: JSON.stringify(safe) });
     });
 }

package/dist/relay/dispatcher.js

@@ -40,7 +40,7 @@
  */
 import { BadRequestError, NotFoundError } from "../server/handlers/errors.js";
 import { handlePathAutocomplete } from "../server/handlers/paths-autocomplete.js";
-import { handleCreateProject, handleDeleteProject, handleListProjects, handleListSessionsByProject, handleUpdateProject, } from "../server/handlers/projects.js";
+import { handleBindStudioProject, handleCreateProject, handleDeleteProject, handleListProjects, handleListSessionsByProject, handleUpdateProject, } from "../server/handlers/projects.js";
 import { handleCompactSession, handleCreateSession, handleDeleteSession, handleForkSession, handleGetSessionDetail, handleGetSessionMemoryDetails, handleGetSessionMemoryStatus, handleUpdateSession, } from "../server/handlers/sessions.js";
 import { shutdownState } from "../server/shutdown.js";
 import { handleAutoResearch } from "./auto-research.js";
@@ -76,6 +76,14 @@ export function matchRoute(method, path) {
             return { route: "create_session" };
         return null;
     }
+    // /api/projects/:id/bind-studio
+    const bindStudioMatch = /^\/api\/projects\/([^/]+)\/bind-studio$/.exec(cleanPath);
+    if (bindStudioMatch) {
+        const id = decodeURIComponent(bindStudioMatch[1]);
+        if (method === "POST")
+            return { route: "bind_studio", id };
+        return null;
+    }
     // /api/projects/:id  and  /api/projects/:id/sessions
     const projectMatch = /^\/api\/projects\/([^/]+)(\/sessions)?$/.exec(cleanPath);
     if (projectMatch) {
@@ -251,6 +259,16 @@ async function dispatchRoute(match, body, deps) {
             });
             return result;
         }
+        case "bind_studio": {
+            const result = await handleBindStudioProject(store, id, asObject(body));
+            safePublish(publishMetaEvent, logger, {
+                type: "project_studio_bound",
+                projectId: id,
+                studioProjectId: result.studioProjectId,
+                studioProjectName: result.studioProjectName,
+            });
+            return result;
+        }
         case "list_project_sessions": {
             const activeIds = manager.getActiveTurnSessionIds();
             const sessions = handleListSessionsByProject(store, id);

package/dist/server/handlers/projects.js

@@ -21,6 +21,7 @@
  */
 import { validateProjectPath } from "../paths.js";
 import { BadRequestError, NotFoundError } from "./errors.js";
+import { writeStudioBindingAt } from "../../studio-binding.js";
 export function handleListProjects(store) {
     return store.listProjects();
 }
@@ -78,6 +79,40 @@ export function handleDeleteProject(store, id) {
         throw new NotFoundError("Project not found");
     return { sessionIds: result.sessionIds };
 }
+/**
+ * Bind a local project directory to an Aexol Studio project by writing
+ * `.aexol/aexol.jsonc` into the project's filesystem path.
+ */
+export async function handleBindStudioProject(store, id, body) {
+    const project = store.getProject(id);
+    if (!project)
+        throw new NotFoundError("Project not found");
+    if (typeof body.studioProjectId !== "string" || !body.studioProjectId.trim()) {
+        throw new BadRequestError("studioProjectId (non-empty string) is required");
+    }
+    const studioProjectId = body.studioProjectId.trim();
+    const studioTeamId = typeof body.studioTeamId === "string" && body.studioTeamId.trim()
+        ? body.studioTeamId.trim()
+        : undefined;
+    const studioProjectName = typeof body.studioProjectName === "string" && body.studioProjectName.trim()
+        ? body.studioProjectName.trim()
+        : undefined;
+    const binding = {
+        $schema: "https://aexol.ai/schemas/studio-binding.json",
+        projectId: studioProjectId,
+        ...(studioTeamId ? { teamId: studioTeamId } : {}),
+        ...(studioProjectName ? { name: studioProjectName } : {}),
+    };
+    await writeStudioBindingAt(project.path, binding);
+    // Re-read to pick up the freshly written studio fields
+    const updated = store.getProject(id);
+    return {
+        project: updated,
+        studioProjectId,
+        studioProjectName: studioProjectName || studioProjectId,
+        ...(studioTeamId ? { studioTeamId } : {}),
+    };
+}
 export function handleListSessionsByProject(store, id) {
     const project = store.getProject(id);
     if (!project)

package/dist/server/session-stream.js

@@ -699,6 +699,12 @@ export class SessionStreamManager {
         stream.loopOriginalPrompt = null;
         stream.loopGoal = null;
         stream.loopIterationCount = 0;
+        // Capture whether a turn is in-flight BEFORE we dispose the bridge.
+        // dispose() tears down pi, which can cause the in-flight prompt()
+        // promise to reject synchronously/microtask and emit an error event
+        // through handleBridgeEvent — which clears currentTurn. We must
+        // broadcast agent_end regardless of what dispose() does to currentTurn.
+        const hadTurn = stream.currentTurn != null;
         // Dispose the pi bridge immediately — this tears down pi's session and
         // unsubscribe. The bridge's own event handler is detached; no further
         // events will flow. We broadcast agent_end ourselves below.
@@ -718,8 +724,10 @@ export class SessionStreamManager {
         stream.currentMessageId = null;
         stream.lastFlushedEventCount = 0;
         // Broadcast agent_end so all subscribers close their open turn and
-        // re-enable their composers.
-        if (stream.currentTurn) {
+        // re-enable their composers. Use the pre-disposal flag — dispose()
+        // may have cleared currentTurn via an error event from the torn-down
+        // pi session.
+        if (hadTurn) {
             this.broadcast(stream, { type: "agent_end" });
             stream.currentTurn = null;
         }

package/dist/studio-binding.js

@@ -79,6 +79,26 @@ export async function writeStudioBinding(binding) {
         "\n";
     await writeFile(bindingPath(), content, "utf8");
 }
+/**
+ * Persist a Studio binding at an arbitrary project path (creates `.aexol/`
+ * under that directory). Uses the same format as `writeStudioBinding`.
+ */
+export async function writeStudioBindingAt(projectPath, binding) {
+    const dir = join(projectPath, BINDING_DIR);
+    try {
+        await access(dir, constants.F_OK);
+    }
+    catch {
+        await mkdir(dir, { recursive: true });
+    }
+    const content = `// Aexol Studio Binding\n` +
+        `// Links this repository to a Studio project.\n` +
+        `// Schema: https://aexol.ai/schemas/studio-binding.json\n` +
+        `\n` +
+        JSON.stringify(binding, null, 2) +
+        "\n";
+    await writeFile(join(dir, BINDING_FILE), content, "utf8");
+}
 /**
  * Remove the local Studio binding file.
  * Returns `true` when the file existed and was deleted, `false` otherwise (no-op).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.6.8",
+  "version": "0.7.0",
   "description": "Always-on coding agent for Aexol — branded pi wrapper with relay-based browser access.",
   "type": "module",
   "private": false,