@getpaseo/server 0.1.91-beta.1 → 0.1.91

package/dist/scripts/supervisor.js

@@ -127,6 +127,26 @@ export function runSupervisor(options) {
                 execArgv: workerExecArgv,
             });
         }
+        const currentChild = child;
+        const heartbeat = setInterval(() => {
+            const message = { type: "paseo:supervisor-heartbeat" };
+            if (currentChild.connected) {
+                currentChild.send?.(message, (error) => {
+                    if (error) {
+                        writeLifecycleLog("Worker heartbeat IPC send failed", {
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                });
+            }
+            else {
+                writeLifecycleLog("Worker heartbeat skipped because IPC channel is disconnected");
+            }
+        }, 1000);
+        heartbeat.unref();
+        child.on("disconnect", () => {
+            writeLifecycleLog("Worker IPC channel disconnected");
+        });
         child.stdout?.on("data", (chunk) => {
             process.stdout.write(chunk);
             writeDurableChunk(chunk);
@@ -157,6 +177,7 @@ export function runSupervisor(options) {
             requestRestart("Restart requested by worker");
         });
         child.on("close", (code, signal) => {
+            clearInterval(heartbeat);
             const exitDescriptor = describeExit(code, signal);
             writeLifecycleLog("Worker exited", { code, signal, exit: exitDescriptor });
             if (shuttingDown) {

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

@@ -163,7 +163,6 @@ export interface AgentMetricsSnapshot {
 export declare class AgentManager {
     private readonly clients;
     private readonly providerEnabled;
-    private readonly providerDerivedFromId;
     private readonly agents;
     private readonly timelineStore;
     private readonly agentsAwaitingInitialSnapshotPersist;
@@ -337,6 +336,7 @@ export declare class AgentManager {
     private dispatchStream;
     private dispatch;
     private normalizeConfig;
+    private prepareSessionConfig;
     private applyDaemonAppendSystemPrompt;
     private buildLaunchContext;
     private requireAvailableClient;

package/dist/server/server/agent/agent-manager.js

@@ -10,9 +10,9 @@ import { InMemoryAgentTimelineStore, } from "./agent-timeline-store.js";
 import { AGENT_STREAM_COALESCE_DEFAULT_WINDOW_MS, AgentStreamCoalescer, } from "./agent-stream-coalescer.js";
 import { ForegroundRunState } from "./foreground-run-state.js";
 import { getAgentProviderDefinition } from "@getpaseo/protocol/provider-manifest";
-import { IMPORTABLE_PROVIDERS } from "./provider-registry.js";
 import { invokeRewindCapability } from "./rewind/rewind.js";
 import { isSystemInjectedEnvelope } from "./agent-prompt.js";
+import { stripInternalPaseoMcpServer, withRuntimePaseoMcpServer } from "./runtime-mcp-config.js";
 const RELOAD_SESSION_CLOSE_TIMEOUT_MS = 3000;
 const INTERRUPT_SESSION_TIMEOUT_MS = 2000;
 const STORED_AGENT_CAPABILITIES = {
@@ -54,7 +54,7 @@ function buildStoredAgentConfig(record) {
     }
     if (record.config.mcpServers != null)
         config.mcpServers = record.config.mcpServers;
-    return config;
+    return stripInternalPaseoMcpServer(config);
 }
 export { AGENT_LIFECYCLE_STATUSES };
 function resolveInitialAttention(input) {
@@ -126,7 +126,6 @@ export class AgentManager {
     constructor(options) {
         this.clients = new Map();
         this.providerEnabled = new Map();
-        this.providerDerivedFromId = new Map();
         this.agents = new Map();
         this.timelineStore = new InMemoryAgentTimelineStore();
         this.agentsAwaitingInitialSnapshotPersist = new Set();
@@ -166,7 +165,6 @@ export class AgentManager {
         for (const [provider, definition] of Object.entries(input.providerDefinitions)) {
             if (definition) {
                 this.providerEnabled.set(provider, definition.enabled);
-                this.providerDerivedFromId.set(provider, definition.derivedFromProviderId ?? null);
             }
         }
         for (const [provider, client] of Object.entries(input.clients)) {
@@ -303,15 +301,9 @@ export class AgentManager {
             .slice(0, limit);
     }
     isProviderImportable(provider, providerFilter) {
-        if (!IMPORTABLE_PROVIDERS.includes(provider)) {
-            return false;
-        }
         if (this.providerEnabled.get(provider) === false) {
             return false;
         }
-        if (this.providerDerivedFromId.get(provider) != null) {
-            return false;
-        }
         if (providerFilter && !providerFilter.has(provider)) {
             return false;
         }
@@ -427,27 +419,15 @@ export class AgentManager {
     }
     async createAgent(config, agentId, options) {
         const resolvedAgentId = validateAgentId(agentId ?? this.idFactory(), "createAgent");
-        const injectedConfig = this.mcpBaseUrl == null
-            ? config
-            : {
-                ...config,
-                mcpServers: {
-                    paseo: {
-                        type: "http",
-                        url: `${this.mcpBaseUrl}?callerAgentId=${resolvedAgentId}`,
-                    },
-                    ...config.mcpServers,
-                },
-            };
-        this.requireEnabledProvider(injectedConfig.provider);
-        const normalizedConfig = this.applyDaemonAppendSystemPrompt(await this.normalizeConfig(injectedConfig));
+        const { storedConfig, launchConfig } = await this.prepareSessionConfig(config, resolvedAgentId);
+        this.requireEnabledProvider(storedConfig.provider);
         const launchContext = this.buildLaunchContext(resolvedAgentId, options?.env);
         const client = await this.requireAvailableClient({
-            provider: normalizedConfig.provider,
+            provider: storedConfig.provider,
         });
         const createOptions = this.buildCreateSessionOptions(options);
-        const session = await client.createSession(normalizedConfig, launchContext, createOptions);
-        return this.registerSession(session, normalizedConfig, resolvedAgentId, {
+        const session = await client.createSession(launchConfig, launchContext, createOptions);
+        return this.registerSession(session, storedConfig, resolvedAgentId, {
             labels: options?.labels,
             workspaceId: options?.workspaceId,
             initialTitle: options?.initialTitle,
@@ -468,29 +448,15 @@ export class AgentManager {
             ...overrides,
             provider: handle.provider,
         };
-        const normalizedConfig = this.applyDaemonAppendSystemPrompt(await this.normalizeConfig(mergedConfig));
-        const resumeOverrides = { ...overrides };
-        let hasResumeOverrides = overrides !== undefined;
-        if (normalizedConfig.model !== mergedConfig.model) {
-            resumeOverrides.model = normalizedConfig.model;
-            hasResumeOverrides = true;
-        }
-        if (normalizedConfig.modeId !== mergedConfig.modeId) {
-            resumeOverrides.modeId = normalizedConfig.modeId;
-            hasResumeOverrides = true;
-        }
-        if (metadata.daemonAppendSystemPrompt !== normalizedConfig.daemonAppendSystemPrompt) {
-            resumeOverrides.daemonAppendSystemPrompt = normalizedConfig.daemonAppendSystemPrompt;
-            hasResumeOverrides = true;
-        }
+        const { storedConfig, launchConfig } = await this.prepareSessionConfig(mergedConfig, resolvedAgentId);
         const launchContext = this.buildLaunchContext(resolvedAgentId);
         const client = this.requireClient(handle.provider);
         const available = await client.isAvailable();
         if (!available) {
             throw new Error(`Provider '${handle.provider}' is not available. Please ensure the CLI is installed.`);
         }
-        const session = await client.resumeSession(handle, hasResumeOverrides ? resumeOverrides : undefined, launchContext);
-        return this.registerSession(session, normalizedConfig, resolvedAgentId, options);
+        const session = await client.resumeSession(handle, launchConfig, launchContext);
+        return this.registerSession(session, storedConfig, resolvedAgentId, options);
     }
     // Hot-reload an active agent session with config overrides. By default the
     // in-memory timeline is preserved (used for voice-mode toggles and similar
@@ -517,11 +483,11 @@ export class AgentManager {
             ...overrides,
             provider,
         };
-        const normalizedConfig = this.applyDaemonAppendSystemPrompt(await this.normalizeConfig(refreshConfig));
+        const { storedConfig, launchConfig } = await this.prepareSessionConfig(refreshConfig, agentId);
         const launchContext = this.buildLaunchContext(agentId);
         const session = handle
-            ? await client.resumeSession(handle, normalizedConfig, launchContext)
-            : await client.createSession(normalizedConfig, launchContext);
+            ? await client.resumeSession(handle, launchConfig, launchContext)
+            : await client.createSession(launchConfig, launchContext);
         this.agentStreamCoalescer.flushAndDiscard(agentId);
         // Remove the existing agent entry before swapping sessions
         this.agents.delete(agentId);
@@ -539,7 +505,7 @@ export class AgentManager {
             this.timelineStore.delete(agentId);
         }
         // Preserve existing labels and timeline during reload.
-        return this.registerSession(session, normalizedConfig, agentId, {
+        return this.registerSession(session, storedConfig, agentId, {
             labels: existing.labels,
             createdAt: existing.createdAt,
             updatedAt: existing.updatedAt,
@@ -2503,6 +2469,15 @@ export class AgentManager {
         }
         return normalized;
     }
+    async prepareSessionConfig(config, agentId) {
+        const storedConfig = await this.normalizeConfig(stripInternalPaseoMcpServer(config));
+        const launchConfig = this.applyDaemonAppendSystemPrompt(withRuntimePaseoMcpServer({
+            config: storedConfig,
+            agentId,
+            mcpBaseUrl: this.mcpBaseUrl,
+        }));
+        return { storedConfig, launchConfig };
+    }
     applyDaemonAppendSystemPrompt(config) {
         const daemonAppendSystemPrompt = this.appendSystemPrompt.trim();
         const next = { ...config };

package/dist/server/server/agent/agent-sdk-types.d.ts

@@ -12,6 +12,11 @@ export interface McpStdioServerConfig {
     command: string;
     args?: string[];
     env?: Record<string, string>;
+    /**
+     * When true, all tools from this server are always included in the prompt
+     * and never deferred behind tool search. Honored by the Claude provider.
+     */
+    alwaysLoad?: boolean;
 }
 /**
  * HTTP-based MCP server.
@@ -20,6 +25,11 @@ export interface McpHttpServerConfig {
     type: "http";
     url: string;
     headers?: Record<string, string>;
+    /**
+     * When true, all tools from this server are always included in the prompt
+     * and never deferred behind tool search. Honored by the Claude provider.
+     */
+    alwaysLoad?: boolean;
 }
 /**
  * SSE-based MCP server (Server-Sent Events over HTTP).
@@ -28,6 +38,11 @@ export interface McpSseServerConfig {
     type: "sse";
     url: string;
     headers?: Record<string, string>;
+    /**
+     * When true, all tools from this server are always included in the prompt
+     * and never deferred behind tool search. Honored by the Claude provider.
+     */
+    alwaysLoad?: boolean;
 }
 /**
  * Canonical MCP server configuration.

package/dist/server/server/agent/prompt-attachments.js

@@ -45,6 +45,14 @@ export function renderPromptAttachmentAsText(attachment) {
             });
             return lines.join("\n");
         }
+        case "uploaded_file": {
+            return [
+                `Uploaded file: ${attachment.fileName}`,
+                `Path: ${attachment.path}`,
+                `MIME: ${attachment.mimeType}`,
+                `Size: ${attachment.size} bytes`,
+            ].join("\n");
+        }
         default:
             throw new Error("unreachable");
     }

package/dist/server/server/agent/provider-registry.d.ts

@@ -19,7 +19,6 @@ export interface ProviderDefinition extends AgentProviderDefinition {
     fetchModels: (options: ListModelsOptions) => Promise<AgentModelDefinition[]>;
     fetchModes: (options: ListModesOptions) => Promise<AgentMode[]>;
 }
-export { IMPORTABLE_PROVIDERS } from "@getpaseo/protocol/importable-providers";
 export interface BuildProviderRegistryOptions {
     runtimeSettings?: AgentProviderRuntimeSettingsMap;
     providerOverrides?: Record<string, ProviderOverride>;

package/dist/server/server/agent/provider-registry.js

@@ -14,7 +14,6 @@ function isNonEmptyStringArray(value) {
     return value.length > 0;
 }
 export { AGENT_PROVIDER_DEFINITIONS, getAgentProviderDefinition };
-export { IMPORTABLE_PROVIDERS } from "@getpaseo/protocol/importable-providers";
 const PROVIDER_CLIENT_FACTORIES = {
     claude: (logger, runtimeSettings) => new ClaudeAgentClient({
         logger,
@@ -34,9 +33,22 @@ const PROVIDER_CLIENT_FACTORIES = {
         env: runtimeSettings?.env,
     }),
     opencode: (logger, runtimeSettings) => new OpenCodeAgentClient(logger, runtimeSettings),
-    pi: (logger, runtimeSettings) => new PiRpcAgentClient({
+    pi: (logger, runtimeSettings, options) => new PiRpcAgentClient({
         logger,
         runtimeSettings,
+        providerParams: options?.providerParams,
+    }),
+    omp: (logger, runtimeSettings, options) => new PiRpcAgentClient({
+        logger,
+        runtimeSettings: mergeRuntimeSettings({
+            command: {
+                mode: "replace",
+                argv: ["omp"],
+            },
+        }, runtimeSettings),
+        providerParams: options?.providerParams ?? {
+            sessionDir: "~/.omp/agent/sessions",
+        },
     }),
     mock: (logger) => new MockLoadTestAgentClient(logger),
     "mock-slow": () => new MockSlowProviderClient(),
@@ -292,11 +304,13 @@ function buildResolvedBuiltinProviders(providerOverrides, runtimeSettings, optio
             runtimeSettings: mergedRuntimeSettings,
             profileModels: override?.models ?? [],
             additionalModels: override?.additionalModels ?? [],
-            profileModelsAreAdditive: definition.id === "claude",
-            enabled: override?.enabled !== false,
+            profileModelsAreAdditive: false,
+            enabled: override?.enabled ?? definition.enabledByDefault ?? true,
             derivedFromProviderId: null,
+            providerParams: override?.params,
             createBaseClient: (logger) => factory(logger, mergedRuntimeSettings, {
                 workspaceGitService: options.workspaceGitService,
+                providerParams: override?.params,
             }),
         });
     }
@@ -330,6 +344,7 @@ function addDerivedProviders(resolvedProviders, providerOverrides) {
                 profileModelsAreAdditive: false,
                 enabled: override.enabled !== false,
                 derivedFromProviderId: null,
+                providerParams: override.params,
                 createBaseClient: (logger) => providerId === "cursor"
                     ? new CursorACPAgentClient({
                         logger,
@@ -356,6 +371,7 @@ function addDerivedProviders(resolvedProviders, providerOverrides) {
         const mergedRuntimeSettings = mergeRuntimeSettings(baseProvider.runtimeSettings, toRuntimeSettings(override));
         const baseDefinition = baseProvider.definition;
         const baseFactory = getProviderClientFactory(baseProviderId);
+        const providerParams = override.params ?? baseProvider.providerParams;
         resolvedProviders.set(providerId, {
             definition: createDerivedDefinition(providerId, baseDefinition, override),
             runtimeSettings: mergedRuntimeSettings,
@@ -364,7 +380,9 @@ function addDerivedProviders(resolvedProviders, providerOverrides) {
             profileModelsAreAdditive: false,
             enabled: override.enabled !== false,
             derivedFromProviderId: baseProviderId,
+            providerParams,
             createBaseClient: (logger) => baseFactory(logger, mergedRuntimeSettings, {
+                providerParams,
                 customProvider: {
                     id: providerId,
                     label: override.label ?? providerId,

package/dist/server/server/agent/provider-snapshot-manager.js

@@ -6,6 +6,24 @@ import { withTimeout } from "../../utils/promise-timeout.js";
 import { buildProviderRegistry, shutdownAgentClients, } from "./provider-registry.js";
 import { applyMutableProviderConfigToOverrides } from "../daemon-config-store.js";
 const DEFAULT_REFRESH_TIMEOUT_MS = 30000;
+const REFRESH_TIMEOUT_ENV_VAR = "PASEO_PROVIDER_REFRESH_TIMEOUT_MS";
+// Provider refresh probes can be slow on cold starts (e.g. Copilot's first
+// `copilot --acp` invocation, OpenCode workspace probes with many MCP servers).
+// Allow operators to bump the ceiling via env var without rebuilding.
+function resolveRefreshTimeoutMs(option) {
+    if (typeof option === "number" && Number.isFinite(option) && option > 0) {
+        return option;
+    }
+    const fromEnv = process.env[REFRESH_TIMEOUT_ENV_VAR];
+    if (fromEnv) {
+        // Number() handles scientific notation (e.g. "6e4") which parseInt would silently truncate.
+        const parsed = Number(fromEnv);
+        if (Number.isFinite(parsed) && parsed > 0) {
+            return parsed;
+        }
+    }
+    return DEFAULT_REFRESH_TIMEOUT_MS;
+}
 export class ProviderSnapshotManager {
     constructor(options) {
         this.snapshots = new Map();
@@ -19,7 +37,7 @@ export class ProviderSnapshotManager {
         this.runtimeSettings = options.runtimeSettings;
         this.providerOverrides = options.providerOverrides;
         this.baseProviderOverrides = options.providerOverrides;
-        this.refreshTimeoutMs = options.refreshTimeoutMs ?? DEFAULT_REFRESH_TIMEOUT_MS;
+        this.refreshTimeoutMs = resolveRefreshTimeoutMs(options.refreshTimeoutMs);
         this.providerRegistry = this.buildRegistry();
         this.providerClients = { ...this.extraClients };
     }

package/dist/server/server/agent/providers/claude/agent.d.ts

@@ -1,7 +1,7 @@
-import { type AgentDefinition, type SDKMessage } from "@anthropic-ai/claude-agent-sdk";
+import { type AgentDefinition, type McpServerConfig as ClaudeSdkMcpServerConfig, type SDKMessage } from "@anthropic-ai/claude-agent-sdk";
 import type { Logger } from "pino";
 import { type ClaudeQueryFactory } from "./query.js";
-import { type AgentCapabilityFlags, type AgentClient, type AgentCreateSessionOptions, type AgentFeature, type AgentLaunchContext, type AgentMetadata, type AgentModelDefinition, type AgentPersistenceHandle, type AgentSession, type AgentSessionConfig, type AgentTimelineItem, type ListModelsOptions, type ListPersistedAgentsOptions, type PersistedAgentDescriptor } from "../../agent-sdk-types.js";
+import { type AgentCapabilityFlags, type AgentClient, type AgentCreateSessionOptions, type AgentFeature, type AgentLaunchContext, type AgentMetadata, type AgentModelDefinition, type AgentPersistenceHandle, type AgentSession, type AgentSessionConfig, type AgentTimelineItem, type ListModelsOptions, type ListPersistedAgentsOptions, type McpServerConfig, type PersistedAgentDescriptor } from "../../agent-sdk-types.js";
 import { type ProviderRuntimeSettings } from "../../provider-launch-config.js";
 export declare function normalizeClaudeAskUserQuestionUpdatedInput(updatedInput: AgentMetadata | undefined, fallbackInput: AgentMetadata | undefined): AgentMetadata;
 interface EventIdentifiers {
@@ -21,8 +21,10 @@ interface ClaudeAgentClientOptions {
     runtimeSettings?: ProviderRuntimeSettings;
     queryFactory?: ClaudeQueryFactory;
     resolveBinary?: () => Promise<string>;
+    configDir?: string;
 }
 export declare function extractUserMessageText(content: unknown): string | null;
+export declare function toClaudeSdkMcpConfig(config: McpServerConfig): ClaudeSdkMcpServerConfig;
 export declare function readEventIdentifiers(message: SDKMessage): EventIdentifiers;
 export declare class ClaudeAgentClient implements AgentClient {
     readonly provider: "claude";
@@ -32,6 +34,7 @@ export declare class ClaudeAgentClient implements AgentClient {
     private readonly runtimeSettings?;
     private readonly queryFactory?;
     private readonly resolveBinary;
+    private readonly configDir?;
     constructor(options: ClaudeAgentClientOptions);
     createSession(config: AgentSessionConfig, launchContext?: AgentLaunchContext, options?: AgentCreateSessionOptions): Promise<AgentSession>;
     resumeSession(handle: AgentPersistenceHandle, overrides?: Partial<AgentSessionConfig>, launchContext?: AgentLaunchContext): Promise<AgentSession>;

package/dist/server/server/agent/providers/claude/agent.js

@@ -539,7 +539,7 @@ function coerceSessionMetadata(metadata) {
     }
     return result;
 }
-function toClaudeSdkMcpConfig(config) {
+export function toClaudeSdkMcpConfig(config) {
     switch (config.type) {
         case "stdio":
             return {
@@ -547,18 +547,21 @@ function toClaudeSdkMcpConfig(config) {
                 command: config.command,
                 args: config.args,
                 env: config.env,
+                alwaysLoad: config.alwaysLoad,
             };
         case "http":
             return {
                 type: "http",
                 url: config.url,
                 headers: config.headers,
+                alwaysLoad: config.alwaysLoad,
             };
         case "sse":
             return {
                 type: "sse",
                 url: config.url,
                 headers: config.headers,
+                alwaysLoad: config.alwaysLoad,
             };
     }
     throw new Error("Unhandled MCP server config type");
@@ -922,6 +925,7 @@ export class ClaudeAgentClient {
         this.runtimeSettings = options.runtimeSettings;
         this.queryFactory = options.queryFactory;
         this.resolveBinary = options.resolveBinary ?? (() => resolveClaudeBinary(this.runtimeSettings));
+        this.configDir = options.configDir;
     }
     async createSession(config, launchContext, options) {
         const claudeConfig = this.assertConfig(config);
@@ -961,7 +965,7 @@ export class ClaudeAgentClient {
     }
     async listModels(_options) {
         // Claude exposes a global catalog here; cwd/force are intentionally irrelevant.
-        return await getClaudeModelsWithSettings(this.logger);
+        return await getClaudeModelsWithSettings(this.logger, this.configDir);
     }
     async listFeatures(config) {
         const claudeConfig = this.assertConfig(config);

package/dist/server/server/agent/providers/claude/models.d.ts

@@ -1,7 +1,7 @@
 import type { Logger } from "pino";
 import type { AgentModelDefinition } from "../../agent-sdk-types.js";
 export declare function getClaudeModels(): AgentModelDefinition[];
-export declare function getClaudeModelsWithSettings(logger: Logger): Promise<AgentModelDefinition[]>;
+export declare function getClaudeModelsWithSettings(logger: Logger, configDir?: string): Promise<AgentModelDefinition[]>;
 /**
  * Normalize a runtime model string (from SDK init message) to a known model ID.
  * Handles the `[1m]` suffix that the SDK appends for 1M context sessions.

package/dist/server/server/agent/providers/claude/models.js

@@ -89,9 +89,9 @@ const CLAUDE_SETTINGS_MODEL_ENV_KEYS = [
 export function getClaudeModels() {
     return CLAUDE_MODELS.map((model) => ({ ...model }));
 }
-export async function getClaudeModelsWithSettings(logger) {
+export async function getClaudeModelsWithSettings(logger, configDir) {
     const hardcodedModels = getClaudeModels();
-    const settingsModels = await readClaudeSettingsModels(logger);
+    const settingsModels = await readClaudeSettingsModels(logger, configDir);
     if (settingsModels.length === 0) {
         return hardcodedModels;
     }
@@ -106,8 +106,8 @@ export async function getClaudeModelsWithSettings(logger) {
     }
     return models;
 }
-async function readClaudeSettingsModels(logger) {
-    const settingsPath = path.join(resolveClaudeConfigDir(), "settings.json");
+async function readClaudeSettingsModels(logger, configDir) {
+    const settingsPath = path.join(resolveClaudeConfigDir(configDir), "settings.json");
     let parsed;
     try {
         const rawSettings = await fs.readFile(settingsPath, "utf8");
@@ -136,8 +136,8 @@ async function readClaudeSettingsModels(logger) {
     }
     return models;
 }
-function resolveClaudeConfigDir() {
-    return process.env.CLAUDE_CONFIG_DIR ?? path.join(os.homedir(), ".claude");
+function resolveClaudeConfigDir(configDir) {
+    return configDir ?? process.env.CLAUDE_CONFIG_DIR ?? path.join(os.homedir(), ".claude");
 }
 function addSettingsModel(models, value, settingsKey) {
     if (typeof value !== "string") {

package/dist/server/server/agent/providers/codex-app-server-agent.js

@@ -34,6 +34,14 @@ const TURN_START_TIMEOUT_MS = 90 * 1000;
 const INTERRUPT_TIMEOUT_MS = 2000;
 const CODEX_PROVIDER = "codex";
 const CODEX_IMAGE_ATTACHMENT_DIR = "paseo-attachments";
+// Codex treats most app-server client names as the model-request originator.
+// This reserved Codex name is non-originating, so requests keep Codex's default
+// CLI identity instead of showing up as Paseo in provider usage logs.
+const CODEX_NON_ORIGINATING_APP_SERVER_CLIENT_INFO = {
+    name: "codex_app_server_daemon",
+    title: "Codex App Server Daemon",
+    version: "0.0.0",
+};
 const ASSISTANT_MESSAGE_BOUNDARY_MARKDOWN = "\n\n---\n\n";
 const CODEX_TOOL_THREAD_ITEM_TYPES = new Set([
     "commandExecution",
@@ -2093,11 +2101,7 @@ export function buildCodexAppServerEnv(runtimeSettings, launchEnv) {
 }
 function buildCodexAppServerInitializeParams() {
     return {
-        clientInfo: {
-            name: "paseo",
-            title: "Paseo",
-            version: "0.0.0",
-        },
+        clientInfo: CODEX_NON_ORIGINATING_APP_SERVER_CLIENT_INFO,
         capabilities: {
             experimentalApi: true,
         },

package/dist/server/server/agent/providers/opencode/test-utils/test-opencode-runtime.d.ts

@@ -76,6 +76,7 @@ export declare class TestOpenCodeClient {
     sessionMessagesResponse: OpenCodeResponse;
     sessionPromptAsyncEvents: unknown[];
     sessionPromptAsyncResponse: OpenCodeResponse;
+    sessionSummarizeEvents: unknown[];
     sessionSummarizeResponse: OpenCodeResponse;
     sessionUpdateResponse: OpenCodeResponse;
     private readonly queuedEventStream;

package/dist/server/server/agent/providers/opencode/test-utils/test-opencode-runtime.js

@@ -70,6 +70,7 @@ export class TestOpenCodeClient {
         this.sessionMessagesResponse = { data: [] };
         this.sessionPromptAsyncEvents = [idleEvent()];
         this.sessionPromptAsyncResponse = {};
+        this.sessionSummarizeEvents = [idleEvent()];
         this.sessionSummarizeResponse = { data: {} };
         this.sessionUpdateResponse = {};
         this.queuedEventStream = createQueuedEventStream();
@@ -182,6 +183,9 @@ export class TestOpenCodeClient {
                 },
                 summarize: async (parameters) => {
                     this.calls.sessionSummarize.push(parameters);
+                    for (const event of this.sessionSummarizeEvents) {
+                        this.emitEvent(event);
+                    }
                     return this.sessionSummarizeResponse;
                 },
                 update: async (parameters) => {

package/dist/server/server/agent/providers/opencode-agent.d.ts

@@ -1,6 +1,6 @@
-import { type AssistantMessage as OpenCodeAssistantMessage, type Event as OpenCodeEvent, type FilePartInput as OpenCodeFilePartInput, type OpencodeClient, type TextPartInput as OpenCodeTextPartInput } from "@opencode-ai/sdk/v2/client";
+import { type AssistantMessage as OpenCodeAssistantMessage, type Event as OpenCodeEvent, type FilePartInput as OpenCodeFilePartInput, type Message as OpenCodeMessage, type OpencodeClient, type Part as OpenCodePart, type TextPartInput as OpenCodeTextPartInput } from "@opencode-ai/sdk/v2/client";
 import type { Logger } from "pino";
-import { type AgentCapabilityFlags, type AgentClient, type AgentCreateSessionOptions, type AgentFeature, type AgentLaunchContext, type AgentMode, type AgentModelDefinition, type AgentPermissionRequest, type AgentPermissionResponse, type AgentPersistenceHandle, type AgentPromptInput, type AgentRunOptions, type AgentRunResult, type AgentRuntimeInfo, type AgentSession, type AgentSessionConfig, type AgentSlashCommand, type AgentStreamEvent, type AgentUsage, type ResolveAgentCreateConfigInput, type ResolveAgentCreateConfigResult, type ListModelsOptions, type ListModesOptions, type ListPersistedAgentsOptions, type PersistedAgentDescriptor, type ToolCallTimelineItem } from "../agent-sdk-types.js";
+import { type AgentCapabilityFlags, type AgentClient, type AgentCreateSessionOptions, type AgentFeature, type AgentLaunchContext, type AgentMode, type AgentModelDefinition, type AgentPermissionRequest, type AgentPermissionResponse, type AgentPersistenceHandle, type AgentPromptInput, type AgentRunOptions, type AgentRunResult, type AgentRuntimeInfo, type AgentSession, type AgentSessionConfig, type AgentSlashCommand, type AgentStreamEvent, type AgentTimelineItem, type AgentUsage, type ResolveAgentCreateConfigInput, type ResolveAgentCreateConfigResult, type ListModelsOptions, type ListModesOptions, type ListPersistedAgentsOptions, type PersistedAgentDescriptor, type ToolCallTimelineItem } from "../agent-sdk-types.js";
 import { isDefaultAgentCreateConfigUnattended } from "../create-agent-mode.js";
 import { type ProviderRuntimeSettings } from "../provider-launch-config.js";
 import { type OpenCodeRuntime } from "./opencode/runtime.js";
@@ -10,6 +10,10 @@ type OpenCodeAgentConfig = AgentSessionConfig & {
     provider: "opencode";
 };
 type OpenCodeMessageRole = "user" | "assistant";
+interface OpenCodeSessionMessage {
+    info: OpenCodeMessage;
+    parts: OpenCodePart[];
+}
 declare function reconcileOpenCodeSessionClose(params: {
     client: Pick<OpencodeClient, "session">;
     sessionId: string;
@@ -79,8 +83,10 @@ declare function mergeOpenCodeStepFinishUsage(usage: AgentUsage, part: {
 }): void;
 declare function hasNormalizedOpenCodeUsage(usage: AgentUsage): boolean;
 declare function buildOpenCodePromptParts(prompt: AgentPromptInput): Array<OpenCodeTextPartInput | OpenCodeFilePartInput>;
+declare function buildOpenCodeSessionTimeline(messages: ReadonlyArray<OpenCodeSessionMessage>): AgentTimelineItem[];
 export declare const __openCodeInternals: {
     buildOpenCodePromptParts: typeof buildOpenCodePromptParts;
+    buildOpenCodeSessionTimeline: typeof buildOpenCodeSessionTimeline;
     buildOpenCodeModelContextWindowLookup: typeof buildOpenCodeModelContextWindowLookup;
     buildOpenCodeModelDefinition: typeof buildOpenCodeModelDefinition;
     buildOpenCodeModelLookupKey: typeof buildOpenCodeModelLookupKey;
@@ -133,6 +139,11 @@ export interface OpenCodeEventTranslationState {
     sessionTotalCostUsd?: number;
     streamedPartKeys: Set<string>;
     emittedStructuredMessageIds: Set<string>;
+    compactionSummaryMessageIds: Set<string>;
+    emittedCompactionPartIds: Set<string>;
+    suppressAssistantMessagesUntilIdle?: {
+        active: boolean;
+    };
     /** Tracks the type of each part by ID, learned from message.part.updated events. */
     partTypes: Map<string, string>;
     subAgentsByCallId?: Map<string, OpenCodeSubAgentActivityState>;
@@ -186,6 +197,9 @@ declare class OpenCodeAgentSession implements AgentSession {
     private streamedPartKeys;
     /** Tracks assistant messages already emitted from structured payloads. */
     private emittedStructuredMessageIds;
+    private compactionSummaryMessageIds;
+    private emittedCompactionPartIds;
+    private suppressAssistantMessagesUntilIdle;
     /** Tracks the type of each part by ID, learned from message.part.updated events. */
     private partTypes;
     private availableModesCache;