@getpaseo/server 0.1.91-beta.1 → 0.1.91

package/dist/server/server/file-upload/index.js

@@ -0,0 +1,158 @@
+import { appendFile, mkdir, rm, writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { FileTransferOpcode } from "@getpaseo/protocol/binary-frames/index";
+import { getErrorMessage } from "@getpaseo/protocol/error-utils";
+export class FileUploadStore {
+    constructor(options) {
+        this.pending = new Map();
+        this.paseoHome = options.paseoHome;
+        this.staleUploadTimeoutMs =
+            options.staleUploadTimeoutMs ?? FileUploadStore.defaultStaleUploadTimeoutMs;
+    }
+    beginUpload(request) {
+        const existingUpload = this.pending.get(request.requestId);
+        if (existingUpload) {
+            this.clearPendingUpload(existingUpload);
+            void existingUpload.queue.then(() => this.removeUploadDirectory(existingUpload));
+        }
+        const fileName = sanitizeFileName(request.fileName);
+        const attempt = existingUpload ? existingUpload.attempt + 1 : 1;
+        const id = buildUploadId(request.requestId, attempt);
+        const uploadDir = join(this.paseoHome, "uploads", id);
+        const upload = {
+            requestId: request.requestId,
+            id,
+            attempt,
+            fileName,
+            mimeType: request.mimeType,
+            size: request.size,
+            path: join(uploadDir, fileName),
+            receivedBytes: 0,
+            started: false,
+            staleTimeout: this.createStaleUploadTimeout(request.requestId),
+            queue: Promise.resolve(),
+        };
+        this.pending.set(request.requestId, upload);
+    }
+    async receiveFrame(frame) {
+        const upload = this.pending.get(frame.requestId);
+        if (!upload) {
+            return null;
+        }
+        this.refreshStaleUploadTimeout(upload);
+        const operation = upload.queue.then(() => this.applyFrame(upload, frame));
+        upload.queue = operation.then(() => undefined, () => undefined);
+        return operation;
+    }
+    async applyFrame(upload, frame) {
+        if (this.pending.get(upload.requestId) !== upload) {
+            return null;
+        }
+        try {
+            if (frame.opcode === FileTransferOpcode.FileBegin) {
+                await this.startWriting(upload);
+                return null;
+            }
+            if (frame.opcode === FileTransferOpcode.FileChunk) {
+                await this.writeChunk(upload, frame.payload);
+                return null;
+            }
+            return await this.completeUpload(upload);
+        }
+        catch (error) {
+            await this.removeFailedUpload(upload);
+            return buildUploadResponse(upload, getErrorMessage(error));
+        }
+    }
+    async startWriting(upload) {
+        await mkdir(join(this.paseoHome, "uploads", upload.id), { recursive: true });
+        await writeFile(upload.path, new Uint8Array());
+        upload.started = true;
+    }
+    async writeChunk(upload, bytes) {
+        if (!upload.started) {
+            throw new Error("Upload chunks arrived before file begin.");
+        }
+        const nextReceivedBytes = upload.receivedBytes + bytes.byteLength;
+        if (nextReceivedBytes > upload.size) {
+            throw new Error(`Upload exceeded declared size: expected ${upload.size}, received ${nextReceivedBytes}.`);
+        }
+        await appendFile(upload.path, bytes);
+        upload.receivedBytes += bytes.byteLength;
+    }
+    async completeUpload(upload) {
+        this.clearPendingUpload(upload);
+        if (upload.receivedBytes !== upload.size) {
+            await this.removeUploadDirectory(upload);
+            return buildUploadResponse(upload, `Upload size mismatch: expected ${upload.size}, received ${upload.receivedBytes}.`);
+        }
+        return buildUploadResponse(upload, null);
+    }
+    createStaleUploadTimeout(requestId) {
+        const timeout = setTimeout(() => {
+            this.expireStaleUpload(requestId);
+        }, this.staleUploadTimeoutMs);
+        timeout.unref?.();
+        return timeout;
+    }
+    refreshStaleUploadTimeout(upload) {
+        clearTimeout(upload.staleTimeout);
+        upload.staleTimeout = this.createStaleUploadTimeout(upload.requestId);
+    }
+    expireStaleUpload(requestId) {
+        const upload = this.pending.get(requestId);
+        if (!upload) {
+            return;
+        }
+        this.clearPendingUpload(upload);
+        const cleanup = upload.queue.then(() => this.removeUploadDirectory(upload), () => this.removeUploadDirectory(upload));
+        upload.queue = cleanup.then(() => undefined, () => undefined);
+    }
+    clearPendingUpload(upload) {
+        clearTimeout(upload.staleTimeout);
+        if (this.pending.get(upload.requestId) === upload) {
+            this.pending.delete(upload.requestId);
+        }
+    }
+    async removeFailedUpload(upload) {
+        this.clearPendingUpload(upload);
+        await this.removeUploadDirectory(upload);
+    }
+    async removeUploadDirectory(upload) {
+        await rm(join(this.paseoHome, "uploads", upload.id), { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+FileUploadStore.defaultStaleUploadTimeoutMs = 10 * 60 * 1000;
+function buildUploadResponse(upload, error) {
+    return {
+        type: "file.upload.response",
+        payload: {
+            requestId: upload.requestId,
+            file: error
+                ? null
+                : {
+                    type: "uploaded_file",
+                    id: upload.id,
+                    fileName: upload.fileName,
+                    mimeType: upload.mimeType,
+                    size: upload.size,
+                    path: upload.path,
+                },
+            error,
+        },
+    };
+}
+function sanitizeUploadId(value) {
+    return value.replace(/[^a-zA-Z0-9._-]/g, "_") || "file";
+}
+function buildUploadId(requestId, attempt) {
+    const baseId = `upload_${sanitizeUploadId(requestId)}`;
+    return attempt === 1 ? baseId : `${baseId}_${attempt}`;
+}
+function sanitizeFileName(value) {
+    const name = basename(value)
+        .replace(/[^a-zA-Z0-9._ -]/g, "_")
+        .trim();
+    return name.length > 0 && name !== "." && name !== ".." ? name : "upload";
+}
+//# sourceMappingURL=index.js.map

package/dist/server/server/loop-service.d.ts

@@ -13,16 +13,16 @@ declare const LoopLogEntrySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     text: string;
     level: "error" | "info";
-    source: "worker" | "loop" | "verifier" | "verify-check";
-    timestamp: string;
     seq: number;
+    timestamp: string;
+    source: "worker" | "loop" | "verifier" | "verify-check";
     iteration: number | null;
 }, {
     text: string;
     level: "error" | "info";
-    source: "worker" | "loop" | "verifier" | "verify-check";
-    timestamp: string;
     seq: number;
+    timestamp: string;
+    source: "worker" | "loop" | "verifier" | "verify-check";
     iteration: number | null;
 }>;
 declare const LoopVerifyCheckResultSchema: z.ZodObject<{
@@ -312,16 +312,16 @@ declare const LoopRecordSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         text: string;
         level: "error" | "info";
-        source: "worker" | "loop" | "verifier" | "verify-check";
-        timestamp: string;
         seq: number;
+        timestamp: string;
+        source: "worker" | "loop" | "verifier" | "verify-check";
         iteration: number | null;
     }, {
         text: string;
         level: "error" | "info";
-        source: "worker" | "loop" | "verifier" | "verify-check";
-        timestamp: string;
         seq: number;
+        timestamp: string;
+        source: "worker" | "loop" | "verifier" | "verify-check";
         iteration: number | null;
     }>, "many">;
     nextLogSeq: z.ZodNumber;
@@ -382,9 +382,9 @@ declare const LoopRecordSchema: z.ZodObject<{
     logs: {
         text: string;
         level: "error" | "info";
-        source: "worker" | "loop" | "verifier" | "verify-check";
-        timestamp: string;
         seq: number;
+        timestamp: string;
+        source: "worker" | "loop" | "verifier" | "verify-check";
         iteration: number | null;
     }[];
     nextLogSeq: number;
@@ -443,9 +443,9 @@ declare const LoopRecordSchema: z.ZodObject<{
     logs: {
         text: string;
         level: "error" | "info";
-        source: "worker" | "loop" | "verifier" | "verify-check";
-        timestamp: string;
         seq: number;
+        timestamp: string;
+        source: "worker" | "loop" | "verifier" | "verify-check";
         iteration: number | null;
     }[];
     nextLogSeq: number;

package/dist/server/server/persisted-config.d.ts

@@ -3,6 +3,7 @@ import type { AgentProviderRuntimeSettingsMap } from "./agent/provider-launch-co
 export declare const LogLevelSchema: z.ZodEnum<["trace", "debug", "info", "warn", "error", "fatal"]>;
 export declare const LogFormatSchema: z.ZodEnum<["pretty", "json"]>;
 export declare const PersistedConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
     version: z.ZodOptional<z.ZodLiteral<1>>;
     daemon: z.ZodOptional<z.ZodEffects<z.ZodObject<{
         listen: z.ZodOptional<z.ZodString>;
@@ -229,6 +230,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             command: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
@@ -322,6 +324,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
             order: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             description?: string | undefined;
+            params?: Record<string, unknown> | undefined;
             label?: string | undefined;
             enabled?: boolean | undefined;
             command?: string[] | undefined;
@@ -355,6 +358,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
             order?: number | undefined;
         }, {
             description?: string | undefined;
+            params?: Record<string, unknown> | undefined;
             label?: string | undefined;
             enabled?: boolean | undefined;
             command?: string[] | undefined;
@@ -388,6 +392,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
             order?: number | undefined;
         }>>, Record<string, {
             description?: string | undefined;
+            params?: Record<string, unknown> | undefined;
             label?: string | undefined;
             enabled?: boolean | undefined;
             command?: string[] | undefined;
@@ -421,6 +426,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
             order?: number | undefined;
         }>, Record<string, {
             description?: string | undefined;
+            params?: Record<string, unknown> | undefined;
             label?: string | undefined;
             enabled?: boolean | undefined;
             command?: string[] | undefined;
@@ -454,6 +460,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
             order?: number | undefined;
         }>>, Record<string, {
             description?: string | undefined;
+            params?: Record<string, unknown> | undefined;
             label?: string | undefined;
             enabled?: boolean | undefined;
             command?: string[] | undefined;
@@ -523,6 +530,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
         } | undefined;
         providers?: Record<string, {
             description?: string | undefined;
+            params?: Record<string, unknown> | undefined;
             label?: string | undefined;
             enabled?: boolean | undefined;
             command?: string[] | undefined;
@@ -924,6 +932,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
         } | undefined;
         providers?: Record<string, {
             description?: string | undefined;
+            params?: Record<string, unknown> | undefined;
             label?: string | undefined;
             enabled?: boolean | undefined;
             command?: string[] | undefined;
@@ -957,6 +966,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
             order?: number | undefined;
         }> | undefined;
     } | undefined;
+    $schema?: string | undefined;
     app?: {
         baseUrl?: string | undefined;
     } | undefined;
@@ -1061,6 +1071,7 @@ export declare const PersistedConfigSchema: z.ZodObject<{
         } | undefined;
         providers?: unknown;
     } | undefined;
+    $schema?: string | undefined;
     app?: {
         baseUrl?: string | undefined;
     } | undefined;

package/dist/server/server/persisted-config.js

@@ -129,7 +129,7 @@ const AgentMetadataGenerationSchema = z
     providers: z.array(StructuredGenerationProviderConfigSchema).optional(),
 })
     .strict();
-const BUILTIN_PROVIDER_IDS = ["claude", "codex", "copilot", "opencode", "pi"];
+const BUILTIN_PROVIDER_IDS = ["claude", "codex", "copilot", "opencode", "pi", "omp"];
 function isLegacyProviderEntry(value) {
     if (!value || typeof value !== "object" || Array.isArray(value)) {
         return false;
@@ -169,6 +169,7 @@ function normalizeAgentProviders(value) {
 }
 export const PersistedConfigSchema = z
     .object({
+    $schema: z.string().optional(),
     // v1 schema marker
     version: z.literal(1).optional(),
     // v1 config layout

package/dist/server/server/persistence-hooks.js

@@ -1,3 +1,4 @@
+import { stripInternalPaseoMcpServer } from "./agent/runtime-mcp-config.js";
 function getLogger(logger) {
     return logger.child({ module: "persistence" });
 }
@@ -21,7 +22,8 @@ export function attachAgentStoragePersistence(logger, agentManager, storage) {
     return unsubscribe;
 }
 export function buildConfigOverrides(record) {
-    return {
+    return stripInternalPaseoMcpServer({
+        provider: record.provider,
         cwd: record.cwd,
         modeId: record.lastModeId ?? record.config?.modeId ?? undefined,
         model: record.config?.model ?? undefined,
@@ -30,7 +32,7 @@ export function buildConfigOverrides(record) {
         extra: record.config?.extra ?? undefined,
         systemPrompt: record.config?.systemPrompt ?? undefined,
         mcpServers: record.config?.mcpServers ?? undefined,
-    };
+    });
 }
 export function buildSessionConfig(record, options) {
     const validProviders = options?.validProviders;
@@ -39,7 +41,7 @@ export function buildSessionConfig(record, options) {
         return null;
     }
     const overrides = buildConfigOverrides(record);
-    return {
+    return stripInternalPaseoMcpServer({
         provider: record.provider,
         cwd: record.cwd,
         modeId: overrides.modeId,
@@ -49,7 +51,7 @@ export function buildSessionConfig(record, options) {
         extra: overrides.extra,
         systemPrompt: overrides.systemPrompt,
         mcpServers: overrides.mcpServers,
-    };
+    });
 }
 export function isStoredAgentProviderAvailable(record, validProviders) {
     return buildSessionConfig(record, { validProviders }) !== null;

package/dist/server/server/session.d.ts

@@ -1,7 +1,7 @@
 import { type ClientCapability } from "@getpaseo/protocol/client-capabilities";
 import { type AgentSnapshotPayload, type SessionInboundMessage, type SessionOutboundMessage, type WorkspaceSetupSnapshot } from "./messages.js";
 import type { TerminalManager } from "../terminal/terminal-manager.js";
-import { type TerminalStreamFrame } from "@getpaseo/protocol/binary-frames/index";
+import { type BinaryFrame } from "@getpaseo/protocol/binary-frames/index";
 import type { SpeechToTextProvider, TextToSpeechProvider } from "./speech/speech-provider.js";
 import type { TurnDetectionProvider } from "./speech/turn-detection-provider.js";
 import type { VoiceCallerContext, VoiceSpeakHandler } from "./voice-types.js";
@@ -181,6 +181,7 @@ export declare class Session {
     private readonly workspaceSetupSnapshots;
     private readonly workspaceGitFetchSubscriptions;
     private readonly workspaceGitSubscriptions;
+    private readonly fileUploads;
     private readonly workspaceDirectory;
     private registerVoiceSpeakHandler?;
     private unregisterVoiceSpeakHandler?;
@@ -286,7 +287,7 @@ export declare class Session {
     private dispatchScheduleMessage;
     private dispatchMiscMessage;
     resetPeakInflight(): void;
-    handleBinaryFrame(frame: TerminalStreamFrame): void;
+    handleBinaryFrame(binaryFrame: BinaryFrame): Promise<void>;
     private handleRestartServerRequest;
     private handleShutdownServerRequest;
     private emitLifecycleIntent;
@@ -420,6 +421,8 @@ export declare class Session {
      * Handle read-only file explorer requests scoped to a workspace cwd
      */
     private handleFileExplorerRequest;
+    private handleFileUploadRequest;
+    private handleFileTransferFrame;
     /**
      * Handle project icon request for a given cwd
      */

package/dist/server/server/session.js

@@ -8,6 +8,7 @@ import { CLIENT_CAPS } from "@getpaseo/protocol/client-capabilities";
 import { serializeAgentStreamEvent, } from "./messages.js";
 import { TerminalSessionController } from "../terminal/terminal-session-controller.js";
 import { encodeFileTransferFrame, FileTransferOpcode, } from "@getpaseo/protocol/binary-frames/index";
+import { FileUploadStore } from "./file-upload/index.js";
 import { CursorError } from "./pagination/cursor.js";
 import { SortablePager } from "./pagination/sortable-pager.js";
 import { TTSManager } from "./agent/tts-manager.js";
@@ -327,6 +328,7 @@ export class Session {
         this.onLifecycleIntent = onLifecycleIntent ?? null;
         this.downloadTokenStore = downloadTokenStore;
         this.pushTokenStore = pushTokenStore;
+        this.fileUploads = new FileUploadStore({ paseoHome });
         this.paseoHome = paseoHome;
         this.worktreesRoot = worktreesRoot;
         this.sessionLogger = logger.child({
@@ -1322,6 +1324,9 @@ export class Session {
                 return this.handleProjectIconRequest(msg);
             case "file_download_token_request":
                 return this.handleFileDownloadTokenRequest(msg);
+            case "file.upload.request":
+                this.handleFileUploadRequest(msg);
+                return undefined;
             default:
                 return undefined;
         }
@@ -1419,8 +1424,12 @@ export class Session {
     resetPeakInflight() {
         this.peakInflightRequests = this.inflightRequests;
     }
-    handleBinaryFrame(frame) {
-        this.terminalController.handleBinaryFrame(frame);
+    async handleBinaryFrame(binaryFrame) {
+        if (binaryFrame.kind === "file_transfer") {
+            await this.handleFileTransferFrame(binaryFrame.frame);
+            return;
+        }
+        this.terminalController.handleBinaryFrame(binaryFrame.frame);
     }
     async handleRestartServerRequest(requestId, reason) {
         const payload = {
@@ -4395,6 +4404,15 @@ export class Session {
             });
         }
     }
+    handleFileUploadRequest(request) {
+        this.fileUploads.beginUpload(request);
+    }
+    async handleFileTransferFrame(frame) {
+        const response = await this.fileUploads.receiveFrame(frame);
+        if (response) {
+            this.emit(response);
+        }
+    }
     /**
      * Handle project icon request for a given cwd
      */

package/dist/server/server/speech/providers/local/runtime.js

@@ -67,6 +67,7 @@ export async function initializeLocalSpeechServices(params) {
     });
     const workerClient = localConfig
         ? new LocalSpeechWorkerClient({
+            logger,
             config: {
                 modelsDir: localConfig.modelsDir,
                 voiceSttModel: localModels.voiceLocalSttModel,

package/dist/server/server/speech/providers/local/worker-client.d.ts

@@ -1,4 +1,5 @@
 import { EventEmitter } from "node:events";
+import { Readable } from "node:stream";
 import type pino from "pino";
 import type { SpeechStreamResult, SpeechToTextProvider, StreamingTranscriptionSession, TextToSpeechProvider } from "../../speech-provider.js";
 import type { TurnDetectionProvider, TurnDetectionSession } from "../../turn-detection-provider.js";
@@ -6,20 +7,24 @@ import type { LocalSpeechSessionKind, LocalSpeechTranscriptionResult, LocalSpeec
 interface LocalSpeechWorkerProcess {
     connected: boolean;
     killed: boolean;
+    pid?: number;
+    stderr?: Readable | null;
     send(message: LocalSpeechWorkerRequest, callback: (error: Error | null) => void): boolean;
     disconnect(): void;
     kill(): boolean;
     on(event: "message", listener: (message: LocalSpeechWorkerToParentMessage) => void): this;
-    on(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+    on(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
 }
 interface LocalSpeechWorkerClientOptions {
     config: LocalSpeechWorkerConfig;
+    logger: pino.Logger;
     requestTimeoutMs?: number;
     idleTtlMs?: number;
     forkWorker?: () => LocalSpeechWorkerProcess;
 }
 export declare class LocalSpeechWorkerClient {
     private readonly config;
+    private readonly logger;
     private readonly requestTimeoutMs;
     private readonly idleTtlMs;
     private readonly forkWorker;
@@ -27,8 +32,12 @@ export declare class LocalSpeechWorkerClient {
     private readonly activeSessionIds;
     private readonly sessionEmitters;
     private worker;
+    private workerPid;
+    private stderrTail;
+    private stderrLineBuffer;
     private inFlightRequests;
     private idleTimer;
+    private readonly intentionalWorkerCloses;
     constructor(options: LocalSpeechWorkerClientOptions);
     synthesizeSpeech(text: string): Promise<SpeechStreamResult>;
     transcribeVoice(audio: Buffer, format: string): Promise<LocalSpeechTranscriptionResult>;
@@ -45,10 +54,14 @@ export declare class LocalSpeechWorkerClient {
     shutdown(): void;
     private sendRequest;
     private ensureWorker;
+    private handleWorkerStderr;
     private handleWorkerMessage;
     private handleWorkerExit;
+    private describePendingRequests;
+    private getStderrTail;
     private rejectAllPending;
     private emitSessionError;
+    private emitErrorIfObserved;
     private scheduleIdleShutdownIfReady;
     private clearIdleTimer;
 }