replicas-engine 0.1.451 → 0.1.453

package/dist/src/index.js

@@ -43,10 +43,13 @@ function createErrorResult(error) {
 }
 
 // ../shared/src/agent.ts
-var VALID_AGENT_PROVIDERS = ["claude", "codex", "cursor", "opencode", "relay"];
+var VALID_AGENT_PROVIDERS = ["claude", "codex", "cursor", "opencode", "pi", "relay"];
 var VALID_CODING_AGENT_PROVIDERS = VALID_AGENT_PROVIDERS.filter(
   (provider) => provider !== "relay"
 );
+function isValidAgentProvider(value) {
+  return VALID_AGENT_PROVIDERS.some((p) => p === value);
+}
 var VALID_THINKING_LEVELS = ["low", "medium", "high", "xhigh", "max"];
 var CODEX_REASONING_EFFORT_BY_THINKING_LEVEL = {
   low: "low",
@@ -166,6 +169,7 @@ var DEFAULT_CHAT_TITLES = {
   codex: "Codex",
   cursor: "Cursor",
   opencode: "Opencode",
+  pi: "Pi",
   relay: "Relay"
 };
 function isDefaultChat(chat) {
@@ -188,6 +192,13 @@ var GPT_5_6_LUNA_MODEL = "gpt-5.6-luna";
 var DEFAULT_CODEX_MODEL = GPT_5_6_SOL_MODEL;
 var DEFAULT_CURSOR_MODEL = "composer-2.5";
 var DEFAULT_OPENCODE_MODEL = "z-ai/glm-5.2";
+var DEFAULT_PI_MODEL = DEFAULT_OPENCODE_MODEL;
+var OPENROUTER_MODELS = [
+  DEFAULT_OPENCODE_MODEL,
+  "minimax/minimax-m3",
+  "xiaomi/mimo-v2.5-pro",
+  "moonshotai/kimi-k2.6"
+];
 function normalizeClaudeModel(model) {
   if (model === "opus" || model === CLAUDE_OPUS_1M_MODEL || model === LEGACY_CLAUDE_OPUS_1M_MODEL) {
     return DEFAULT_CLAUDE_MODEL;
@@ -256,7 +267,8 @@ var AGENT_MODELS = {
     CLAUDE_HAIKU_4_5_MODEL,
     "kimi-k2.5"
   ],
-  opencode: [DEFAULT_OPENCODE_MODEL, "minimax/minimax-m3", "xiaomi/mimo-v2.5-pro", "moonshotai/kimi-k2.6"],
+  opencode: OPENROUTER_MODELS,
+  pi: OPENROUTER_MODELS,
   relay: [CLAUDE_FABLE_5_MODEL, DEFAULT_CLAUDE_MODEL, CLAUDE_SONNET_5_MODEL]
 };
 var MODEL_LABELS = {
@@ -516,7 +528,7 @@ var WORKSPACE_SIZES = ["small", "large"];
 var INVALID_WORKSPACE_SIZE_ERROR = `Invalid size: must be one of ${WORKSPACE_SIZES.join(", ")}`;
 
 // ../shared/src/e2b.ts
-var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-07-19-v3";
+var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-07-19-v5";
 
 // ../shared/src/runtime-env.ts
 function shellQuotePosix(value) {
@@ -672,7 +684,7 @@ var SLASH_COMMANDS = [
     command: "/plan",
     description: "Switch to plan mode and optionally send a prompt.",
     argumentHint: "[prompt]",
-    providers: ["claude", "codex", "cursor", "opencode", "relay"]
+    providers: ["claude", "codex", "cursor", "opencode", "pi", "relay"]
   },
   {
     command: "/fast",
@@ -2730,6 +2742,9 @@ var DESKTOP_NOVNC_PORT = 6080;
 
 // ../shared/src/engine/v1.ts
 var MERGED_MESSAGE_SEPARATOR = "\n\n<!-- replicas:merged -->\n\n";
+var ENGINE_HEALTH_WAIT_HEADER = "X-Replicas-Health-Wait";
+var ENGINE_HEALTH_WAIT_QUERY_PARAM = "wait_ms";
+var ENGINE_HEALTH_MAX_WAIT_MS = 2e3;
 function normalizeCodexAspTranscriptStatus(status, failed = false) {
   if (failed || status === "failed" || status === "declined") return "failed";
   if (status === "completed") return "completed";
@@ -5012,6 +5027,9 @@ function detectCursorAuthMethod() {
 function detectOpencodeAuthMethod() {
   return existsSync3(OPENCODE_AUTH_PATH) || ENGINE_ENV.OPENROUTER_API_KEY ? "api_key" : "none";
 }
+function detectPiAuthMethod() {
+  return ENGINE_ENV.OPENROUTER_API_KEY ? "api_key" : "none";
+}
 async function detectGitIdentityConfigured() {
   try {
     const { stdout } = await execFileAsync("git", ["config", "--global", "user.name"]);
@@ -5069,6 +5087,7 @@ function createDefaultDetails() {
     codexAuthMethod: "none",
     cursorAuthMethod: "none",
     opencodeAuthMethod: "none",
+    piAuthMethod: "none",
     lastUpdatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
@@ -5104,6 +5123,7 @@ var EnvironmentDetailsService = class {
     details.codexAuthMethod = detectCodexAuthMethod();
     details.cursorAuthMethod = detectCursorAuthMethod();
     details.opencodeAuthMethod = detectOpencodeAuthMethod();
+    details.piAuthMethod = detectPiAuthMethod();
     details.gitIdentityConfigured = gitIdentityConfigured;
     const ghConfigured = existsSync3(GH_HOSTS_PATH);
     details.githubAccessConfigured = ghConfigured;
@@ -5854,9 +5874,9 @@ async function registerDesktopPreview() {
 
 // src/services/chat/chat-service.ts
 import { existsSync as existsSync7 } from "fs";
-import { appendFile as appendFile3, copyFile, mkdir as mkdir13, readFile as readFile14, rename as rename2, rm as rm2 } from "fs/promises";
+import { appendFile as appendFile3, copyFile, mkdir as mkdir14, readFile as readFile14, rename as rename2, rm as rm2 } from "fs/promises";
 import { homedir as homedir15 } from "os";
-import { join as join21 } from "path";
+import { join as join22 } from "path";
 import { randomUUID as randomUUID5 } from "crypto";
 
 // src/managers/claude-manager.ts
@@ -6576,16 +6596,16 @@ var CodingAgentManager = class {
     });
   }
   recordHistoryEvent(type, payload, historyFile) {
-    const eventPayload = {};
+    const eventPayload2 = {};
     if (payload && typeof payload === "object") {
-      Object.assign(eventPayload, payload);
+      Object.assign(eventPayload2, payload);
     } else {
-      eventPayload.value = payload;
+      eventPayload2.value = payload;
     }
     const event = {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       type,
-      payload: eventPayload
+      payload: eventPayload2
     };
     this.onEvent(event);
     historyFile.append(event);
@@ -8569,7 +8589,7 @@ var DEFAULT_CODEX_ARGS = ["app-server", "--listen", "stdio://"];
 var MIN_CODEX_CLI_VERSION = "0.144.0";
 var CODEX_UPGRADE_TIMEOUT_MS = 12e4;
 var codexCliVersionEnsured = null;
-var ENGINE_PACKAGE_VERSION = "0.1.451";
+var ENGINE_PACKAGE_VERSION = "0.1.453";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";
@@ -9447,12 +9467,14 @@ var RELAY_HISTORY_DIR = join15(ENGINE_DIR2, "relay-histories");
 var CODEX_HISTORY_DIR = join15(ENGINE_DIR2, "codex-histories");
 var CURSOR_HISTORY_DIR = join15(ENGINE_DIR2, "cursor-histories");
 var OPENCODE_HISTORY_DIR = join15(ENGINE_DIR2, "opencode-histories");
+var PI_HISTORY_DIR = join15(ENGINE_DIR2, "pi-histories");
 var HISTORY_DIR_BY_PROVIDER = {
   claude: CLAUDE_HISTORY_DIR,
   relay: RELAY_HISTORY_DIR,
   codex: CODEX_HISTORY_DIR,
   cursor: CURSOR_HISTORY_DIR,
-  opencode: OPENCODE_HISTORY_DIR
+  opencode: OPENCODE_HISTORY_DIR,
+  pi: PI_HISTORY_DIR
 };
 
 // src/services/chat/errors.ts
@@ -11744,6 +11766,162 @@ var OpencodeManager = class extends CodingAgentManager {
   }
 };
 
+// src/managers/pi-manager.ts
+import { mkdir as mkdir13 } from "fs/promises";
+import { dirname as dirname7, join as join19 } from "path";
+import {
+  AuthStorage,
+  createAgentSession,
+  ModelRegistry,
+  SessionManager,
+  DefaultResourceLoader
+} from "@mariozechner/pi-coding-agent";
+function eventPayload(event) {
+  return isRecord4(event) ? { ...event } : { value: event };
+}
+function registerCommandProtection(cwd) {
+  return (pi) => {
+    pi.on("tool_call", async (event) => {
+      const command = extractToolCommand(event.input);
+      const result = await evaluateCommandProtection({
+        provider: "pi",
+        source: "pi_tool_call",
+        toolName: event.toolName,
+        toolInput: event.input,
+        command,
+        cwd,
+        toolUseId: event.toolCallId
+      });
+      if (!result.allowed) {
+        reportCommandProtectionBlock({ provider: "pi", toolName: event.toolName, command, reason: result.reason });
+        return { block: true, reason: result.reason ?? "Command blocked by Replicas protection." };
+      }
+      return void 0;
+    });
+  };
+}
+var PiManager = class extends CodingAgentManager {
+  session = null;
+  unsubscribe = null;
+  activeSessionFile = null;
+  historyFilePath;
+  historyFile;
+  constructor(options) {
+    super(options);
+    this.historyFilePath = options.historyFilePath ?? join19(PI_HISTORY_DIR, `${Date.now()}.jsonl`);
+    this.historyFile = new CodexHistoryFile(this.historyFilePath);
+    this.initializeManager(this.processMessageInternal.bind(this));
+  }
+  async initialize() {
+    await mkdir13(dirname7(this.historyFilePath), { recursive: true });
+  }
+  async interruptActiveTurn() {
+    await this.session?.abort();
+  }
+  async steerRequest(request) {
+    if (!this.session?.isStreaming) return false;
+    await this.session.steer(request.message);
+    return true;
+  }
+  async getHistory() {
+    await this.historyFile.flush();
+    const history = await this.historyFile.load();
+    return { thread_id: this.activeSessionFile ?? this.initialSessionId, events: history.events, goal: null };
+  }
+  async listSlashCommands() {
+    await this.initialized;
+    return mergeSlashCommands(...(this.session?.promptTemplates ?? []).map((template) => createProviderSlashCommand("pi", template.name, template.description)).filter((command) => Boolean(command)));
+  }
+  dispose() {
+    this.unsubscribe?.();
+    this.unsubscribe = null;
+    this.session?.dispose();
+    this.session = null;
+  }
+  async ensureSession(request) {
+    if (this.session) {
+      if (request.model && request.model !== this.session.model?.id) {
+        const model2 = this.session.modelRegistry.find("openrouter", request.model);
+        if (model2) await this.session.setModel(model2);
+      }
+      if (request.thinkingLevel) this.session.setThinkingLevel(request.thinkingLevel);
+      return this.session;
+    }
+    const apiKey = ENGINE_ENV.OPENROUTER_API_KEY;
+    if (!apiKey) throw new Error("OpenRouter API key is not configured for Pi.");
+    const authStorage = AuthStorage.inMemory({ openrouter: { type: "api_key", key: apiKey } });
+    const modelRegistry = ModelRegistry.create(authStorage);
+    const openRouterModels = modelRegistry.getAll().filter((candidate) => candidate.provider === "openrouter");
+    const modelTemplate = openRouterModels[0];
+    if (!modelTemplate) throw new Error("Pi OpenRouter model catalog is empty.");
+    modelRegistry.registerProvider("openrouter", {
+      api: modelTemplate.api,
+      apiKey,
+      baseUrl: modelTemplate.baseUrl,
+      models: [
+        ...openRouterModels,
+        ...OPENROUTER_MODELS.filter((id) => !openRouterModels.some((candidate) => candidate.id === id)).map((id) => ({
+          id,
+          name: id,
+          api: modelTemplate.api,
+          baseUrl: modelTemplate.baseUrl,
+          reasoning: modelTemplate.reasoning,
+          input: modelTemplate.input,
+          cost: modelTemplate.cost,
+          contextWindow: modelTemplate.contextWindow,
+          maxTokens: modelTemplate.maxTokens
+        }))
+      ]
+    });
+    const modelId = request.model ?? DEFAULT_PI_MODEL;
+    const model = modelRegistry.find("openrouter", modelId) ?? modelRegistry.find("openrouter", DEFAULT_PI_MODEL);
+    if (!model) throw new Error(`Pi model is not available through OpenRouter: ${modelId}`);
+    const sessionManager = this.initialSessionId ? SessionManager.open(this.initialSessionId, PI_HISTORY_DIR, this.workingDirectory) : SessionManager.create(this.workingDirectory, PI_HISTORY_DIR);
+    const resourceLoader = new DefaultResourceLoader({
+      cwd: this.workingDirectory,
+      agentDir: join19(ENGINE_ENV.HOME_DIR, ".pi", "agent"),
+      extensionFactories: [registerCommandProtection(this.workingDirectory)],
+      appendSystemPrompt: [this.buildCombinedInstructions() ?? ""]
+    });
+    await resourceLoader.reload();
+    const result = await createAgentSession({
+      cwd: this.workingDirectory,
+      authStorage,
+      modelRegistry,
+      model,
+      sessionManager,
+      resourceLoader
+    });
+    this.session = result.session;
+    if (request.thinkingLevel) this.session.setThinkingLevel(request.thinkingLevel);
+    this.activeSessionFile = sessionManager.getSessionFile() ?? null;
+    await this.onSaveSessionId(this.activeSessionFile);
+    this.unsubscribe = this.session.subscribe((event) => this.handleEvent(event));
+    return this.session;
+  }
+  handleEvent(event) {
+    const payload = eventPayload(event);
+    this.recordHistoryEvent(`pi-${event.type}`, payload, this.historyFile);
+  }
+  async processMessageInternal(request) {
+    const session = await this.ensureSession(request);
+    this.recordHistoryEvent("event_msg", { type: "user_message", message: request.message }, this.historyFile);
+    try {
+      const images = request.images && request.images.length > 0 ? (await normalizeImages(request.images)).map((image) => ({
+        type: "image",
+        data: image.source.data,
+        mimeType: image.source.media_type
+      })) : void 0;
+      await session.prompt(request.message, images ? { images } : void 0);
+    } catch (error) {
+      this.recordHistoryEvent("pi-error", { message: error instanceof Error ? error.message : String(error) }, this.historyFile);
+      throw error;
+    } finally {
+      await this.onTurnComplete();
+    }
+  }
+};
+
 // src/managers/relay-tools.ts
 import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
 import { z } from "zod";
@@ -11753,15 +11931,17 @@ function getAvailableRelayProviders(availability) {
   const codexAvailable = availability.codexAvailable ?? false;
   const cursorAvailable = availability.cursorAvailable ?? false;
   const opencodeAvailable = availability.opencodeAvailable ?? false;
+  const piAvailable = availability.piAvailable ?? false;
   const providers = ["claude"];
   if (codexAvailable) providers.push("codex");
   if (cursorAvailable) providers.push("cursor");
   if (opencodeAvailable) providers.push("opencode");
+  if (piAvailable) providers.push("pi");
   providers.push("relay");
   return providers;
 }
 function getAvailableCodeProviders(availability) {
-  return getAvailableRelayProviders(availability).filter((provider) => provider === "codex" || provider === "cursor" || provider === "opencode");
+  return getAvailableRelayProviders(availability).filter((provider) => provider === "codex" || provider === "cursor" || provider === "opencode" || provider === "pi");
 }
 
 // src/managers/relay-tools.ts
@@ -12115,13 +12295,14 @@ function getUsingToolsSection() {
   ];
   return [`# Using your tools`, ...prependBullets(items)].join("\n");
 }
-function getDelegationSection(codexAvailable, cursorAvailable, opencodeAvailable) {
-  const providerList = getAvailableRelayProviders({ codexAvailable, cursorAvailable, opencodeAvailable }).join(", ");
+function getDelegationSection(codexAvailable, cursorAvailable, opencodeAvailable, piAvailable) {
+  const providerList = getAvailableRelayProviders({ codexAvailable, cursorAvailable, opencodeAvailable, piAvailable }).join(", ");
   const spawnDesc = `Create a new subagent with a specific provider (${providerList}), send it a prompt, and wait for its response. Returns the chatId and the agent's final response. You can set a custom timeout via the timeout_minutes parameter (default: 10 minutes).`;
   const claudeModelList = AGENT_MODELS.claude.join(", ");
   const extraAgentLines = [
     codexAvailable ? `Use provider 'codex' for heavy code writing, implementation, and large refactors. Suggested models: ${AGENT_MODELS.codex.join(", ")} (${AGENT_MODELS.codex[0]} is the default).` : null,
     opencodeAvailable ? `Use provider 'opencode' for cheaper routine implementation tasks through OpenRouter-backed open source models. Suggested models: ${AGENT_MODELS.opencode.join(", ")}.` : null,
+    piAvailable ? `Use provider 'pi' for coding tasks through Pi's OpenRouter-backed coding agent. Suggested models: ${AGENT_MODELS.pi.join(", ")}.` : null,
     cursorAvailable ? `Use provider 'cursor' for fast iteration on code changes. Suggested models: ${AGENT_MODELS.cursor.join(", ")}.` : null
   ].filter(Boolean);
   const agentSelectionLines = extraAgentLines.length > 0 ? `${extraAgentLines.join("\n\n")}
@@ -12244,14 +12425,14 @@ function getEnvironmentSection() {
   ].join("\n");
 }
 function buildRelaySystemPrompt(options) {
-  const { customInstructions, codexAvailable, cursorAvailable, opencodeAvailable } = options ?? {};
+  const { customInstructions, codexAvailable, cursorAvailable, opencodeAvailable, piAvailable } = options ?? {};
   const sections = [
     getIntroSection(),
     getSystemSection(),
     getDoingTasksSection(),
     getActionsSection(),
     getUsingToolsSection(),
-    getDelegationSection(codexAvailable ?? false, cursorAvailable ?? false, opencodeAvailable ?? false),
+    getDelegationSection(codexAvailable ?? false, cursorAvailable ?? false, opencodeAvailable ?? false, piAvailable ?? false),
     getToneAndStyleSection(),
     getOutputEfficiencySection(),
     getEnvironmentSection(),
@@ -12284,12 +12465,13 @@ var RelayManager = class {
     const codexAvailable = options.codexAvailable ?? false;
     const cursorAvailable = options.cursorAvailable ?? false;
     const opencodeAvailable = options.opencodeAvailable ?? false;
+    const piAvailable = options.piAvailable ?? false;
     this.inner = new ClaudeManager({
       ...options,
-      systemPromptOverride: (customInstructions) => buildRelaySystemPrompt({ customInstructions, codexAvailable, cursorAvailable, opencodeAvailable }),
+      systemPromptOverride: (customInstructions) => buildRelaySystemPrompt({ customInstructions, codexAvailable, cursorAvailable, opencodeAvailable, piAvailable }),
       tools: RELAY_TOOLS,
       mcpServers: {
-        "relay-subagent-tools": createRelayMcpServer(options.chatId, { codexAvailable, cursorAvailable, opencodeAvailable })
+        "relay-subagent-tools": createRelayMcpServer(options.chatId, { codexAvailable, cursorAvailable, opencodeAvailable, piAvailable })
       },
       envOverrides: {
         CLAUDE_CODE_STREAM_CLOSE_TIMEOUT: "900000"
@@ -12381,17 +12563,17 @@ var keepAliveService = new KeepAliveService();
 // src/services/canvas-service.ts
 import { readdir as readdir6, readFile as readFile12, stat as stat3 } from "fs/promises";
 import { homedir as homedir13 } from "os";
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 var GLOBAL_CANVAS_DIRECTORIES = [
-  join19(homedir13(), ".claude", "plans"),
-  join19(process.env.XDG_DATA_HOME ?? join19(homedir13(), ".local", "share"), "opencode", "plans"),
-  join19(homedir13(), ".replicas", "canvas")
+  join20(homedir13(), ".claude", "plans"),
+  join20(process.env.XDG_DATA_HOME ?? join20(homedir13(), ".local", "share"), "opencode", "plans"),
+  join20(homedir13(), ".replicas", "canvas")
 ];
 async function canvasDirectories() {
   const repositories = await gitService.listRepositories().catch(() => []);
   return [
     ...GLOBAL_CANVAS_DIRECTORIES,
-    ...repositories.map((repository) => join19(repository.path, ".opencode", "plans"))
+    ...repositories.map((repository) => join20(repository.path, ".opencode", "plans"))
   ];
 }
 var CanvasService = class {
@@ -12411,7 +12593,7 @@ var CanvasService = class {
         const { kind } = classifyCanvasFilename(entry.name);
         let sizeBytes = 0;
         try {
-          const s = await stat3(join19(directory, entry.name));
+          const s = await stat3(join20(directory, entry.name));
           sizeBytes = s.size;
         } catch {
           continue;
@@ -12426,7 +12608,7 @@ var CanvasService = class {
     if (!safe) return null;
     const { kind, mimeType } = classifyCanvasFilename(safe);
     for (const directory of await canvasDirectories()) {
-      const filePath = join19(directory, safe);
+      const filePath = join20(directory, safe);
       let sizeBytes = 0;
       let updatedAt = "";
       try {
@@ -12563,13 +12745,13 @@ async function reconcileCanvasItems(filenames) {
 
 // src/services/upload-chat-transcripts.ts
 import { readdir as readdir7, readFile as readFile13 } from "fs/promises";
-import { basename as basename2, join as join20 } from "path";
+import { basename as basename2, join as join21 } from "path";
 import { homedir as homedir14 } from "os";
-var ENGINE_DIR3 = join20(homedir14(), ".replicas", "engine");
+var ENGINE_DIR3 = join21(homedir14(), ".replicas", "engine");
 var HISTORY_DIRS = [
-  join20(ENGINE_DIR3, "claude-histories"),
-  join20(ENGINE_DIR3, "relay-histories"),
-  join20(ENGINE_DIR3, "codex-histories")
+  join21(ENGINE_DIR3, "claude-histories"),
+  join21(ENGINE_DIR3, "relay-histories"),
+  join21(ENGINE_DIR3, "codex-histories")
 ];
 async function flushAllChatTranscripts(chatsById = /* @__PURE__ */ new Map()) {
   let flushed = 0;
@@ -12586,7 +12768,7 @@ async function flushAllChatTranscripts(chatsById = /* @__PURE__ */ new Map()) {
       if (!entry.endsWith(".jsonl")) continue;
       const chatId = basename2(entry, ".jsonl");
       tasks.push(
-        uploadChatTranscript(chatId, join20(dir, entry), chatsById.get(chatId)).then(() => {
+        uploadChatTranscript(chatId, join21(dir, entry), chatsById.get(chatId)).then(() => {
           flushed++;
         }).catch((err) => {
           failed++;
@@ -12665,9 +12847,9 @@ async function flushRepoState() {
 }
 
 // src/services/chat/chat-service.ts
-var CHAT_SENDERS_DIR = join21(ENGINE_DIR2, "chat-senders");
-var CODEX_AUTH_PATH2 = join21(homedir15(), ".codex", "auth.json");
-var OPENCODE_AUTH_PATH2 = join21(homedir15(), ".local", "share", "opencode", "auth.json");
+var CHAT_SENDERS_DIR = join22(ENGINE_DIR2, "chat-senders");
+var CODEX_AUTH_PATH2 = join22(homedir15(), ".codex", "auth.json");
+var OPENCODE_AUTH_PATH2 = join22(homedir15(), ".local", "share", "opencode", "auth.json");
 var CHATS_BACKUP_FILE = `${CHATS_FILE}.bak`;
 function isChatMessageSender(value) {
   if (!isRecord4(value)) return false;
@@ -12679,6 +12861,9 @@ function isCodexAvailable() {
 function isOpencodeAvailable() {
   return existsSync7(OPENCODE_AUTH_PATH2) || Boolean(ENGINE_ENV.OPENROUTER_API_KEY);
 }
+function isPiAvailable() {
+  return Boolean(ENGINE_ENV.OPENROUTER_API_KEY);
+}
 function isCursorAvailable() {
   return Boolean(ENGINE_ENV.CURSOR_API_KEY);
 }
@@ -12727,7 +12912,7 @@ function isPersistedChat(value) {
     return false;
   }
   const candidate = value;
-  return typeof candidate.id === "string" && (candidate.provider === "claude" || candidate.provider === "codex" || candidate.provider === "cursor" || candidate.provider === "opencode" || candidate.provider === "relay") && typeof candidate.title === "string" && typeof candidate.createdAt === "string" && typeof candidate.updatedAt === "string" && (candidate.providerSessionId === null || typeof candidate.providerSessionId === "string") && (candidate.parentChatId === void 0 || candidate.parentChatId === null || typeof candidate.parentChatId === "string") && (candidate.deletedAt === void 0 || candidate.deletedAt === null || typeof candidate.deletedAt === "string");
+  return typeof candidate.id === "string" && typeof candidate.provider === "string" && isValidAgentProvider(candidate.provider) && typeof candidate.title === "string" && typeof candidate.createdAt === "string" && typeof candidate.updatedAt === "string" && (candidate.providerSessionId === null || typeof candidate.providerSessionId === "string") && (candidate.parentChatId === void 0 || candidate.parentChatId === null || typeof candidate.parentChatId === "string") && (candidate.deletedAt === void 0 || candidate.deletedAt === null || typeof candidate.deletedAt === "string");
 }
 function normalizePersistedChat(chat) {
   const isLegacyCodexSdkChat = chat.provider === "codex" && (chat.codexBackend === "sdk" || chat.codexBackend === void 0 && chat.providerSessionId !== null);
@@ -12779,13 +12964,13 @@ var ChatService = class {
   persistInFlight = false;
   persistQueued = false;
   async initialize() {
-    await mkdir13(ENGINE_DIR2, { recursive: true });
-    await mkdir13(CLAUDE_HISTORY_DIR, { recursive: true });
-    await mkdir13(RELAY_HISTORY_DIR, { recursive: true });
-    await mkdir13(CODEX_HISTORY_DIR, { recursive: true });
-    await mkdir13(CURSOR_HISTORY_DIR, { recursive: true });
-    await mkdir13(OPENCODE_HISTORY_DIR, { recursive: true });
-    await mkdir13(CHAT_SENDERS_DIR, { recursive: true });
+    await mkdir14(ENGINE_DIR2, { recursive: true });
+    await mkdir14(CLAUDE_HISTORY_DIR, { recursive: true });
+    await mkdir14(RELAY_HISTORY_DIR, { recursive: true });
+    await mkdir14(CODEX_HISTORY_DIR, { recursive: true });
+    await mkdir14(CURSOR_HISTORY_DIR, { recursive: true });
+    await mkdir14(OPENCODE_HISTORY_DIR, { recursive: true });
+    await mkdir14(CHAT_SENDERS_DIR, { recursive: true });
     const persisted = await this.loadChats();
     for (const chat of persisted) {
       const runtime = this.createRuntimeChat(chat);
@@ -12909,7 +13094,7 @@ var ChatService = class {
     };
   }
   senderFilePath(chatId) {
-    return join21(CHAT_SENDERS_DIR, `${chatId}.jsonl`);
+    return join22(CHAT_SENDERS_DIR, `${chatId}.jsonl`);
   }
   async appendSender(chatId, sender) {
     try {
@@ -13103,7 +13288,7 @@ var ChatService = class {
     return descendants;
   }
   async deleteHistoryFile(persisted) {
-    await rm2(join21(HISTORY_DIR_BY_PROVIDER[persisted.provider], `${persisted.id}.jsonl`), { force: true });
+    await rm2(join22(HISTORY_DIR_BY_PROVIDER[persisted.provider], `${persisted.id}.jsonl`), { force: true });
     await rm2(this.senderFilePath(persisted.id), { force: true });
   }
   async getChatHistory(chatId, page = {}) {
@@ -13177,7 +13362,7 @@ var ChatService = class {
     if (persisted.provider === "claude") {
       provider = new ClaudeManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join21(CLAUDE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join22(CLAUDE_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13186,7 +13371,7 @@ var ChatService = class {
     } else if (persisted.provider === "relay") {
       provider = new RelayManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join21(RELAY_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join22(RELAY_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13194,12 +13379,13 @@ var ChatService = class {
         chatId: persisted.id,
         codexAvailable: isCodexAvailable(),
         opencodeAvailable: isOpencodeAvailable(),
+        piAvailable: isPiAvailable(),
         cursorAvailable: isCursorAvailable()
       });
     } else if (persisted.provider === "cursor") {
       provider = new CursorManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join21(CURSOR_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join22(CURSOR_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13208,7 +13394,16 @@ var ChatService = class {
     } else if (persisted.provider === "opencode") {
       provider = new OpencodeManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join21(OPENCODE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join22(OPENCODE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        initialSessionId: persisted.providerSessionId,
+        onSaveSessionId: saveSession,
+        onTurnComplete: onProviderTurnComplete,
+        onEvent: onProviderEvent
+      });
+    } else if (persisted.provider === "pi") {
+      provider = new PiManager({
+        workingDirectory: this.workingDirectory,
+        historyFilePath: join22(PI_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13217,7 +13412,7 @@ var ChatService = class {
     } else {
       provider = new CodexAspManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join21(CODEX_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join22(CODEX_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13357,7 +13552,7 @@ var ChatService = class {
     });
     uploadChatTranscript(
       chatId,
-      join21(HISTORY_DIR_BY_PROVIDER[chat.persisted.provider], `${chatId}.jsonl`),
+      join22(HISTORY_DIR_BY_PROVIDER[chat.persisted.provider], `${chatId}.jsonl`),
       this.toSummary(chat)
     ).catch((err) => {
       console.error("[ChatService] Failed to upload chat transcript:", { chatId, err });
@@ -13484,7 +13679,7 @@ var ChatService = class {
 // src/services/repo-file-service.ts
 import { execFile as execFile2 } from "child_process";
 import { readFile as readFile15, realpath, stat as stat4 } from "fs/promises";
-import { join as join22, resolve as resolve2, extname as extname2 } from "path";
+import { join as join23, resolve as resolve2, extname as extname2 } from "path";
 var CACHE_TTL_MS = 3e4;
 var SEARCH_TIMEOUT_MS = 15e3;
 var MAX_CONTENT_BYTES = 256 * 1024;
@@ -13644,7 +13839,7 @@ var RepoFileService = class {
     const repo = repos.find((r) => r.name === repoName);
     if (!repo) return null;
     try {
-      const fullPath = await realpath(resolve2(join22(repo.path, filePath)));
+      const fullPath = await realpath(resolve2(join23(repo.path, filePath)));
       const repoRoot = await realpath(repo.path);
       const repoPrefix = repoRoot.endsWith("/") ? repoRoot : repoRoot + "/";
       if (!fullPath.startsWith(repoPrefix) && fullPath !== repoRoot) return null;
@@ -13752,20 +13947,20 @@ var RepoFileService = class {
 import { Hono } from "hono";
 import { z as z2 } from "zod";
 import { readdir as readdir9, stat as stat5, readFile as readFile18 } from "fs/promises";
-import { join as join25, resolve as resolve3 } from "path";
+import { join as join26, resolve as resolve3 } from "path";
 
 // src/services/warm-hooks-service.ts
 import { spawn as spawn4 } from "child_process";
 import { readFile as readFile17 } from "fs/promises";
 import { existsSync as existsSync8 } from "fs";
-import { join as join24 } from "path";
+import { join as join25 } from "path";
 
 // src/services/warm-hook-logs-service.ts
-import { mkdir as mkdir14, readFile as readFile16, writeFile as writeFile6, readdir as readdir8, appendFile as appendFile4, unlink as unlink3 } from "fs/promises";
+import { mkdir as mkdir15, readFile as readFile16, writeFile as writeFile6, readdir as readdir8, appendFile as appendFile4, unlink as unlink3 } from "fs/promises";
 import { homedir as homedir16 } from "os";
-import { join as join23 } from "path";
-var LOGS_DIR2 = join23(homedir16(), ".replicas", "warm-hook-logs");
-var CURRENT_RUN_LOG = join23(LOGS_DIR2, "current-run.log");
+import { join as join24 } from "path";
+var LOGS_DIR2 = join24(homedir16(), ".replicas", "warm-hook-logs");
+var CURRENT_RUN_LOG = join24(LOGS_DIR2, "current-run.log");
 var GLOBAL_FILENAME = "global.json";
 function withPreview2(stored) {
   const preview = buildHookOutputPreview(stored.output);
@@ -13773,7 +13968,7 @@ function withPreview2(stored) {
 }
 var WarmHookLogsService = class {
   async ensureDir() {
-    await mkdir14(LOGS_DIR2, { recursive: true });
+    await mkdir15(LOGS_DIR2, { recursive: true });
   }
   async saveGlobalHookLog(entry) {
     await this.ensureDir();
@@ -13782,7 +13977,7 @@ var WarmHookLogsService = class {
       hookName: "organization",
       ...entry
     };
-    await writeFile6(join23(LOGS_DIR2, GLOBAL_FILENAME), `${JSON.stringify(log, null, 2)}
+    await writeFile6(join24(LOGS_DIR2, GLOBAL_FILENAME), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async saveEnvironmentHookLog(entry) {
@@ -13792,7 +13987,7 @@ var WarmHookLogsService = class {
       hookName: "environment",
       ...entry
     };
-    await writeFile6(join23(LOGS_DIR2, ENVIRONMENT_HOOK_LOG_FILENAME), `${JSON.stringify(log, null, 2)}
+    await writeFile6(join24(LOGS_DIR2, ENVIRONMENT_HOOK_LOG_FILENAME), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async saveRepoHookLog(repoName, entry) {
@@ -13802,7 +13997,7 @@ var WarmHookLogsService = class {
       hookName: repoName,
       ...entry
     };
-    await writeFile6(join23(LOGS_DIR2, repoHookLogFilename(repoName)), `${JSON.stringify(log, null, 2)}
+    await writeFile6(join24(LOGS_DIR2, repoHookLogFilename(repoName)), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async getAllLogs() {
@@ -13821,7 +14016,7 @@ var WarmHookLogsService = class {
         continue;
       }
       try {
-        const raw = await readFile16(join23(LOGS_DIR2, file), "utf-8");
+        const raw = await readFile16(join24(LOGS_DIR2, file), "utf-8");
         const stored = JSON.parse(raw);
         logs.push(withPreview2(stored));
       } catch {
@@ -13859,7 +14054,7 @@ var WarmHookLogsService = class {
   async getFullOutput(hookType, hookName) {
     const filename = hookType === "global" ? GLOBAL_FILENAME : hookType === "environment" ? ENVIRONMENT_HOOK_LOG_FILENAME : repoHookLogFilename(hookName);
     try {
-      const raw = await readFile16(join23(LOGS_DIR2, filename), "utf-8");
+      const raw = await readFile16(join24(LOGS_DIR2, filename), "utf-8");
       const stored = JSON.parse(raw);
       if (stored.hookType !== hookType || stored.hookName !== hookName) {
         return null;
@@ -13878,7 +14073,7 @@ var warmHookLogsService = new WarmHookLogsService();
 // src/services/warm-hooks-service.ts
 async function readRepoWarmHook(repoPath) {
   for (const filename of REPLICAS_CONFIG_FILENAMES) {
-    const configPath = join24(repoPath, filename);
+    const configPath = join25(repoPath, filename);
     if (!existsSync8(configPath)) {
       continue;
     }
@@ -14262,7 +14457,7 @@ var setWorkspaceNameSchema = z2.object({
   name: z2.string().min(1).max(48)
 });
 var createChatSchema = z2.object({
-  provider: z2.enum(["claude", "codex", "cursor", "opencode", "relay"]),
+  provider: z2.enum(["claude", "codex", "cursor", "opencode", "pi", "relay"]),
   title: z2.string().min(1).optional(),
   parentChatId: z2.string().uuid().optional(),
   clientRequestId: z2.string().min(1).max(128).optional()
@@ -15100,7 +15295,7 @@ data: ${JSON.stringify("Terminal session not found")}
       const logFiles = files.filter((f) => f.endsWith(".log"));
       const sessions = await Promise.all(
         logFiles.map(async (filename) => {
-          const filePath = join25(LOG_DIR, filename);
+          const filePath = join26(LOG_DIR, filename);
           const fileStat = await stat5(filePath);
           const sessionId = filename.replace(/\.log$/, "");
           return {
@@ -15219,6 +15414,11 @@ var heartbeatService = new HeartbeatService();
 // src/index.ts
 var startupStartedAt = performance.now();
 var startupTimings = {};
+var resolveEngineReady = () => {
+};
+var engineReadyPromise = new Promise((resolve4) => {
+  resolveEngineReady = resolve4;
+});
 async function timeStartupStep(name, fn) {
   const startedAt = performance.now();
   try {
@@ -15288,7 +15488,16 @@ var authMiddleware = async (c, next) => {
   await next();
 };
 var chatService = new ChatService(gitService.getWorkspaceRoot());
-app.get("/health", (c) => {
+app.get("/health", async (c) => {
+  const requestedWaitMs = Number(c.req.query(ENGINE_HEALTH_WAIT_QUERY_PARAM));
+  const waitMs = Number.isFinite(requestedWaitMs) ? Math.min(Math.max(requestedWaitMs, 0), ENGINE_HEALTH_MAX_WAIT_MS) : 0;
+  if (!engineReady && waitMs > 0) {
+    await Promise.race([
+      engineReadyPromise,
+      new Promise((resolve4) => setTimeout(resolve4, waitMs))
+    ]);
+  }
+  c.header(ENGINE_HEALTH_WAIT_HEADER, "1");
   const response = {
     status: engineReady ? "active" : "initializing",
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -15477,6 +15686,7 @@ serve(
       await timeStartupStep("github_token_initialize", () => githubTokenManager.start());
     }
     engineReady = true;
+    resolveEngineReady();
     void registerDesktopPreview();
     heartbeatService.start(bootTimeMs);
     if (!IS_WARMING_MODE) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.451",
+  "version": "0.1.453",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",
@@ -35,6 +35,8 @@
     "@connectrpc/connect-node": "1.7.0",
     "@cursor/sdk": "1.0.19",
     "@hono/node-server": "^1.19.5",
+    "@mariozechner/pi-ai": "0.73.1",
+    "@mariozechner/pi-coding-agent": "0.73.1",
     "@opencode-ai/sdk": "1.17.9",
     "hono": "^4.10.3",
     "opencode-ai": "1.17.9",