@aexol/spectral 0.9.194 → 0.9.195

package/dist/server/agent-bridge.d.ts

@@ -53,6 +53,7 @@ import { type AgentSettings } from "./handlers/agent-settings.js";
 import { fetchAllowedModels as defaultFetchAllowedModels } from "../relay/models-fetch.js";
 import type { SessionMemorySnapshot } from "./storage.js";
 import type { ImageAttachment, ServerEvent, WireMessage } from "./wire.js";
+import type { DevProcessRegistry } from "./dev-process-registry.js";
 interface AgentBridgeCompactionOptions {
     customInstructions?: string;
     phaseBoundary?: boolean;
@@ -139,6 +140,8 @@ export interface AgentBridgeOptions {
      * session is not hot-reloaded.
      */
     agentSettings?: AgentSettings;
+    /** Machine-level registry for primary-agent background bash jobs. */
+    devProcessRegistry?: DevProcessRegistry;
     /**
      * Called when cloud-agent discovery reports the cached machine JWT was
      * rejected by the backend (HTTP 401/403 or a GraphQL auth error). The
@@ -371,9 +374,10 @@ export declare class AgentBridge {
      *
      * When `images` is non-empty, each base64-encoded attachment is converted
      * to a spectral `ImageContent` block and passed as `options.images` to
-     * `session.prompt()`. If the current model does not support image inputs,
-     * images are instead converted to text placeholders so the conversation
-     * can continue without errors.
+     * `session.prompt()`. Image-capable models receive the images natively;
+     * models without image support are handled by the spectral-vision-fallback
+     * extension, which replaces images with text descriptions before the
+     * provider request.
      */
     prompt(text: string, images?: ImageAttachment[]): Promise<void>;
     /**

package/dist/server/agent-bridge.d.ts.map

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

package/dist/server/agent-bridge.js

@@ -875,6 +875,7 @@ export class AgentBridge {
             modelRegistry: this.modelRegistry,
             settingsManager,
             sessionId: this.opts.sessionId,
+            devProcessRegistry: this.opts.devProcessRegistry,
         });
         this.session = result.session;
         // Headless UI context: forwards extension notify() calls as wire events
@@ -1042,7 +1043,7 @@ export class AgentBridge {
             return ["text", "image"];
         }
         console.info(`[agent-bridge] Model ${m.modelId} (${m.provider}) reports supportsImages: false ` +
-            `— not adding image to input modalities (vision extension will analyze images before provider requests)`);
+            `— not adding image to input modalities (vision fallback will analyze images before provider requests)`);
         return ["text"];
     }
     registerSyntheticProviders(allowedModels) {
@@ -1344,18 +1345,19 @@ export class AgentBridge {
      *
      * When `images` is non-empty, each base64-encoded attachment is converted
      * to a spectral `ImageContent` block and passed as `options.images` to
-     * `session.prompt()`. If the current model does not support image inputs,
-     * images are instead converted to text placeholders so the conversation
-     * can continue without errors.
+     * `session.prompt()`. Image-capable models receive the images natively;
+     * models without image support are handled by the spectral-vision-fallback
+     * extension, which replaces images with text descriptions before the
+     * provider request.
      */
     async prompt(text, images) {
         if (!this.session)
             throw new Error("AgentBridge.start() not called");
         // Always pass images through to the session.
-        // The spectral-vision-fallback extension intercepts images via the
-        // `context` event and replaces them with text descriptions using a
-        // vision-capable model BEFORE they reach the LLM. This means images
-        // work regardless of whether the main model supports them.
+        // Image-capable models receive the images natively. Models without image
+        // support are handled by the spectral-vision-fallback extension, which
+        // intercepts images via the `context` event and replaces them with text
+        // descriptions from a vision-capable model BEFORE they reach the LLM.
         try {
             if (images && images.length > 0) {
                 const imageContents = images.map((img) => ({

package/dist/server/dev-port-detection.d.ts

@@ -0,0 +1,35 @@
+import type { DetectedDevServer } from "./wire.js";
+/**
+ * Scan all listening TCP ports and group them by owning pid.
+ *
+ * Reuses the ports extension's native-tooling parser rather than
+ * reimplementing lsof/ss/netstat parsing here.
+ */
+export declare function getTcpPortsByPid(): Promise<Map<number, number[]>>;
+/**
+ * Best-effort resolution of a pid's current working directory.
+ *
+ * Swallows all errors and returns null when the process has exited, the
+ * platform is unsupported, or the OS tooling cannot inspect the process.
+ */
+export declare function resolvePidCwd(pid: number): Promise<string | null>;
+export declare function findProjectForCwd(cwd: string | null, projects: Array<{
+    id: string;
+    name: string;
+    path: string;
+}>): {
+    id: string;
+    name: string;
+} | null;
+/**
+ * Scan listening TCP servers and match them to known Spectral projects.
+ *
+ * Results are deduplicated by `pid:port`, project-matched servers are sorted
+ * first, and ties are ordered by port ascending for a stable settings UI.
+ */
+export declare function listDetectedDevServers(projects: Array<{
+    id: string;
+    name: string;
+    path: string;
+}>): Promise<DetectedDevServer[]>;
+//# sourceMappingURL=dev-port-detection.d.ts.map

package/dist/server/dev-port-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-port-detection.d.ts","sourceRoot":"","sources":["../../src/server/dev-port-detection.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAInD;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAevE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BvE;AAED,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,QAAQ,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACzD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYrC;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC3C,QAAQ,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACzD,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsC9B"}

package/dist/server/dev-port-detection.js

@@ -0,0 +1,113 @@
+import { execFile } from "node:child_process";
+import { readlink } from "node:fs/promises";
+import { platform as osPlatform } from "node:os";
+import { promisify } from "node:util";
+import { scanPorts } from "../extensions/ports/platform.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Scan all listening TCP ports and group them by owning pid.
+ *
+ * Reuses the ports extension's native-tooling parser rather than
+ * reimplementing lsof/ss/netstat parsing here.
+ */
+export async function getTcpPortsByPid() {
+    const { entries } = await scanPorts();
+    const byPid = new Map();
+    for (const entry of entries) {
+        if (entry.protocol !== "tcp" || entry.pid === null)
+            continue;
+        const ports = byPid.get(entry.pid) ?? [];
+        if (!ports.includes(entry.port))
+            ports.push(entry.port);
+        byPid.set(entry.pid, ports);
+    }
+    for (const ports of byPid.values()) {
+        ports.sort((a, b) => a - b);
+    }
+    return byPid;
+}
+/**
+ * Best-effort resolution of a pid's current working directory.
+ *
+ * Swallows all errors and returns null when the process has exited, the
+ * platform is unsupported, or the OS tooling cannot inspect the process.
+ */
+export async function resolvePidCwd(pid) {
+    const platform = osPlatform();
+    if (platform === "darwin") {
+        try {
+            const { stdout } = await execFileAsync("lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"], { timeout: 5_000, maxBuffer: 1024 * 1024 });
+            const cwdLine = stdout.split("\n").find((line) => line.startsWith("n"));
+            return cwdLine ? cwdLine.slice(1).trimEnd() : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    if (platform === "linux") {
+        try {
+            return await readlink(`/proc/${pid}/cwd`);
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+export function findProjectForCwd(cwd, projects) {
+    if (!cwd)
+        return null;
+    for (const project of projects) {
+        if (cwd === project.path ||
+            cwd.startsWith(`${project.path}/`) ||
+            cwd.startsWith(`${project.path}\\`)) {
+            return { id: project.id, name: project.name };
+        }
+    }
+    return null;
+}
+/**
+ * Scan listening TCP servers and match them to known Spectral projects.
+ *
+ * Results are deduplicated by `pid:port`, project-matched servers are sorted
+ * first, and ties are ordered by port ascending for a stable settings UI.
+ */
+export async function listDetectedDevServers(projects) {
+    const { entries } = await scanPorts();
+    const seen = new Set();
+    const cwdCache = new Map();
+    const servers = [];
+    for (const entry of entries) {
+        if (entry.protocol !== "tcp" || entry.pid === null)
+            continue;
+        const key = `${entry.pid}:${entry.port}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        let cwd = cwdCache.get(entry.pid);
+        if (cwd === undefined) {
+            cwd = await resolvePidCwd(entry.pid);
+            cwdCache.set(entry.pid, cwd);
+        }
+        const project = findProjectForCwd(cwd, projects);
+        servers.push({
+            id: key,
+            pid: entry.pid,
+            port: entry.port,
+            address: entry.address,
+            process: entry.process,
+            cwd: project ? cwd : null,
+            projectId: project?.id ?? null,
+            projectName: project?.name ?? null,
+        });
+    }
+    return servers.sort((a, b) => {
+        const aMatched = a.projectId !== null ? 0 : 1;
+        const bMatched = b.projectId !== null ? 0 : 1;
+        if (aMatched !== bMatched)
+            return aMatched - bMatched;
+        if (a.port !== b.port)
+            return a.port - b.port;
+        return a.id.localeCompare(b.id);
+    });
+}

package/dist/server/dev-process-registry.d.ts

@@ -0,0 +1,93 @@
+import { BashJobRegistry, type BashJob } from "../sdk/coding-agent/core/bash-jobs.js";
+import { type OutputAccumulator as OutputAccumulatorType } from "../sdk/coding-agent/core/tools/output-accumulator.js";
+import type { DevProcessSummary, ServerEvent } from "./wire.js";
+export type { DevProcessStatus, DevProcessSummary } from "./wire.js";
+/**
+ * Events emitted by the machine-level dev-process registry. Kept as a subset
+ * of `ServerEvent` so the session-stream manager can fan them out unchanged.
+ */
+export type DevProcessRegistryEvent = Extract<ServerEvent, {
+    type: "dev_processes_changed" | "dev_process_output";
+}>;
+/**
+ * Stable definition for a machine-level dev process. Definitions are persisted
+ * in SQLite (`dev_process_definitions`) so a command only has to pass the
+ * startup allow-list once.
+ */
+export interface DevProcessDefinitionInput {
+    definitionId?: string;
+    label?: string;
+    command: string;
+    cwd: string;
+}
+/**
+ * Machine-level registry for background bash jobs that should be visible in
+ * the landing "Dev servers" settings section.
+ *
+ * Extends the session-scoped `BashJobRegistry` so the existing bash tool
+ * factories accept it unchanged, while adding the list/summary surface and
+ * durable pidfile tracking under `<agentDir>/dev-processes/`.
+ */
+export declare class DevProcessRegistry extends BashJobRegistry {
+    private readonly records;
+    private readonly pidDir;
+    private readonly listeners;
+    private portRefresh;
+    constructor(agentDir: string);
+    /**
+     * Subscribe to registry events. Returns an unsubscribe function.
+     * Listeners are invoked synchronously and are expected to be cheap;
+     * a throwing listener is logged and isolated so it cannot break process
+     * tracking.
+     */
+    onEvent(listener: (event: DevProcessRegistryEvent) => void): () => void;
+    create(input: {
+        id?: string;
+        pid?: number;
+        command: string;
+        cwd: string;
+        output: OutputAccumulatorType;
+        fullOutputPath: string;
+        kill: () => void;
+        definitionId?: string;
+        label?: string;
+    }): BashJob;
+    markExited(id: string, exitCode: number | null): void;
+    markKilled(id: string): void;
+    /** List all tracked processes, newest first. */
+    list(): DevProcessSummary[];
+    /**
+     * Spawn a persistent dev process. Unlike the agent's normal background bash
+     * path, this process is NOT force-killed after the 30-minute hard deadline
+     * (`waitForChildProcess(_, 0)`). It remains killable through the registry.
+     */
+    spawnDaemon(definition: DevProcessDefinitionInput): DevProcessSummary;
+    /**
+     * Re-scan listening TCP ports and update any live record whose port set
+     * changed. Called automatically after a new daemon binds and at the end of
+     * pidfile reconciliation; `GET /api/dev-processes` also refreshes eagerly.
+     */
+    refreshPorts(): Promise<void>;
+    private schedulePortRefresh;
+    /**
+     * Kill an existing dev process and start a fresh one from its saved
+     * definition. Returns null when the process id is unknown.
+     */
+    restart(id: string): DevProcessSummary | null;
+    /**
+     * Rehydrate processes from durable pidfiles after a CLI restart.
+     *
+     * A live PID becomes a killable `recovered` record whose output is no
+     * longer attached; a dead PID has its stale pidfile removed.
+     */
+    reconcile(): void;
+    private toSummary;
+    private emitOutput;
+    private emit;
+    private pidfilePath;
+    private writePidfile;
+    private readPidfile;
+    private removePidfile;
+    private isPidAlive;
+}
+//# sourceMappingURL=dev-process-registry.d.ts.map

package/dist/server/dev-process-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-process-registry.d.ts","sourceRoot":"","sources":["../../src/server/dev-process-registry.ts"],"names":[],"mappings":"AAUA,OAAO,EACN,eAAe,EACf,KAAK,OAAO,EACZ,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EAEN,KAAK,iBAAiB,IAAI,qBAAqB,EAC/C,MAAM,sDAAsD,CAAC;AAE9D,OAAO,KAAK,EAEX,iBAAiB,EACjB,WAAW,EACX,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAC5C,WAAW,EACX;IAAE,IAAI,EAAE,uBAAuB,GAAG,oBAAoB,CAAA;CAAE,CACxD,CAAC;AAKF;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACZ;AAkCD;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAEtB;IACJ,OAAO,CAAC,WAAW,CAA8B;gBAErC,QAAQ,EAAE,MAAM;IAK5B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,MAAM,IAAI;IAO9D,MAAM,CAAC,KAAK,EAAE;QACtB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,qBAAqB,CAAC;QAC9B,cAAc,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,MAAM,IAAI,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO;IA4BF,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAoBrD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAoBrC,gDAAgD;IAChD,IAAI,IAAI,iBAAiB,EAAE;IAM3B;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,yBAAyB,GAAG,iBAAiB;IAoErE;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CnC,OAAO,CAAC,mBAAmB;IAO3B;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAiB7C;;;;;OAKG;IACH,SAAS,IAAI,IAAI;IA+DjB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,UAAU;CAQlB"}