ds-harness-remote 0.4.5 → 0.4.7

package/dist/index.js

@@ -4715,7 +4715,15 @@ function projectCodexItem(value, threadId, turnId, sessionId, index) {
     return { ...base, kind: "tool", text: commandExecutionText(item), status: projectItemStatus(item.status), details: { type } };
   }
   if (isToolItemType(type)) {
-    return { ...base, kind: "tool", text: toolCallText(item), status: projectItemStatus(item.status), details: { type } };
+    const images = toolItemImages(item);
+    return {
+      ...base,
+      kind: "tool",
+      text: toolCallText(item),
+      ...images.length === 0 ? {} : { images },
+      status: projectItemStatus(item.status),
+      details: { type }
+    };
   }
   if (type === "fileChange") {
     return { ...base, kind: "file-change", text: fileChangeText(item.changes), status: projectItemStatus(item.status), details: { type } };
@@ -4786,6 +4794,22 @@ function itemImages(item) {
     }];
   });
 }
+function toolItemImages(item) {
+  const candidates = [
+    isRecord(item.result) ? item.result : void 0,
+    isRecord(item.output) ? item.output : void 0,
+    Array.isArray(item.contentItems) ? { content: item.contentItems } : void 0,
+    Array.isArray(item.output) ? { content: item.output } : void 0
+  ];
+  for (const candidate of candidates) {
+    if (candidate === void 0 || !Array.isArray(candidate.content))
+      continue;
+    const images = itemImages(candidate);
+    if (images.length > 0)
+      return images;
+  }
+  return [];
+}
 function isImageContent(value) {
   return value.type === "image" || value.type === "input_image";
 }
@@ -4796,7 +4820,7 @@ function imageDataUri(value) {
     return parsed.url;
   if (typeof value.data !== "string" || !isCanonicalBase64(value.data))
     return void 0;
-  const mediaType = typeof value.mediaType === "string" ? value.mediaType : sniffImageMediaType(value.data);
+  const mediaType = typeof value.mediaType === "string" ? value.mediaType : typeof value.mimeType === "string" ? value.mimeType : sniffImageMediaType(value.data);
   return mediaType !== void 0 && CODEX_IMAGE_MEDIA_TYPES.has(mediaType) ? `data:${mediaType};base64,${value.data}` : void 0;
 }
 function parseDataImageUrl(value) {
@@ -4885,7 +4909,8 @@ function toolCallText(item) {
   }
   const label = toolLabel(item);
   const error = compactUnknown(item.error);
-  const result = compactUnknown(item.result ?? item.contentItems);
+  const rawResult = item.result ?? item.contentItems;
+  const result = itemText(isRecord(rawResult) ? rawResult : {}) ?? (toolItemImages(item).length > 0 ? void 0 : compactUnknown(rawResult));
   return boundedText([label, error, result].filter((value) => value !== void 0 && value !== "").join("\n\n")) || void 0;
 }
 function fileChangeText(value) {
@@ -14388,6 +14413,9 @@ var MAX_CODEX_IMAGE_BASE64 = 288 * 1024 * 1024;
 var CODEX_IMAGE_MEDIA_TYPES2 = /* @__PURE__ */ new Set(["image/png", "image/jpeg", "image/webp", "image/gif"]);
 var CODEX_IMAGE_ATTACHMENT_PREFIX = "codex-image:";
 var DATA_IMAGE_URL2 = /^data:(image\/(?:png|jpeg|webp|gif));base64,([A-Za-z0-9+/]+={0,2})$/u;
+function codexProjectWorkspaceId(projectId) {
+  return `${CODEX_WORKSPACE_PREFIX}project:${projectId}`;
+}
 async function discoverCodexVirtualWorkspaces(client, signal) {
   return (await loadCatalog(client, signal)).workspaces;
 }
@@ -14806,6 +14834,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
       liveItems: /* @__PURE__ */ new Map(),
       liveToolOutput: /* @__PURE__ */ new Map(),
       liveToolResultSeq: /* @__PURE__ */ new Map(),
+      pendingToolImages: [],
       requestId: this.pendingRequestIds.get(sessionId),
       ...history.activeTurnId === void 0 ? {} : { activeTurnId: history.activeTurnId }
     };
@@ -15015,18 +15044,24 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
     follow.completedItems.add(itemId);
     this.closeItemStreamBlocks(follow, itemId, itemText2(item));
     if (type === "agentMessage" && follow.streamActive && follow.streamedBlocks.size === 0) this.finishStream(follow);
+    const supplementalImages = type === "agentMessage" ? follow.pendingToolImages : [];
     for (const event of itemEvents(
       item,
       follow.turn,
       1,
       follow.requestId,
       this.modelSelection(follow.sessionId),
-      follow.sessionId
+      follow.sessionId,
+      supplementalImages
     )) {
       if (event.type === "tool/call" && follow.startedItems.has(itemId)) continue;
       if (event.type === "tool/result") this.pushToolResult(follow, itemId, event);
       else this.pushEvent(follow, event.type, event.data, event.view);
     }
+    if (type === "agentMessage" && supplementalImages.length > 0) follow.pendingToolImages = [];
+    else if (type !== void 0 && isToolItemType2(type)) {
+      follow.pendingToolImages.push(...toolOutputImageBlocks(item));
+    }
     follow.liveItems.delete(itemId);
     follow.liveToolOutput.delete(itemId);
     follow.liveToolResultSeq.delete(itemId);
@@ -15167,6 +15202,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
     follow.liveItems.clear();
     follow.liveToolOutput.clear();
     follow.liveToolResultSeq.clear();
+    follow.pendingToolImages = [];
   }
   emitRemoteEvent(event, args) {
     for (const queue of this.eventStreams.values()) queue.push({ type: "emit", event, args });
@@ -15512,6 +15548,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
       liveItems: /* @__PURE__ */ new Map(),
       liveToolOutput: /* @__PURE__ */ new Map(),
       liveToolResultSeq: /* @__PURE__ */ new Map(),
+      pendingToolImages: [],
       requestId: this.pendingRequestIds.get(sessionId),
       rcOnly: true,
       ...history.activeTurnId === void 0 ? {} : { activeTurnId: history.activeTurnId }
@@ -15813,15 +15850,29 @@ function projectCodexNativeHistory(thread, sessionId) {
   };
   for (const rawTurn of array(thread.turns)) {
     const turn = record(rawTurn);
+    const turnItems = array(turn.items).map(record);
+    const toolImages = turnItems.flatMap(toolOutputImageBlocks);
+    let imageOwner = -1;
+    for (let index = 0; index < turnItems.length; index += 1) {
+      if (turnItems[index].type === "agentMessage") imageOwner = index;
+    }
     turnNumber += 1;
     const turnActive = isActiveCodexTurn(turn);
     const time = normalizeTime(turn.createdAt) || normalizeTime(turn.startedAt) || normalizeTime(thread.createdAt) || Date.now();
     append("turn/start", { turn: turnNumber }, time);
     append("step/start", { turn: turnNumber, step: 1 }, time);
-    for (const rawItem of array(turn.items)) {
-      const item = record(rawItem);
+    for (let itemIndex = 0; itemIndex < turnItems.length; itemIndex += 1) {
+      const item = turnItems[itemIndex];
       let toolCallSeq;
-      for (const event of itemEvents(item, turnNumber, 1, void 0, modelSelection(), sessionId)) {
+      for (const event of itemEvents(
+        item,
+        turnNumber,
+        1,
+        void 0,
+        modelSelection(),
+        sessionId,
+        itemIndex === imageOwner ? toolImages : []
+      )) {
         const eventSeq = append(
           event.type,
           event.data,
@@ -15878,7 +15929,7 @@ function paginateCodexNativeHistory(history, request) {
     ...history.activeTurnId === void 0 ? {} : { activeTurnId: history.activeTurnId }
   };
 }
-function itemEvents(item, turn, step, requestId, selection = modelSelection(), sessionId = CODEX_SESSION_PREFIX) {
+function itemEvents(item, turn, step, requestId, selection = modelSelection(), sessionId = CODEX_SESSION_PREFIX, supplementalImages = []) {
   const type = string(item.type);
   const id2 = string(item.id) ?? `${turn}:${step}:${hashString(JSON.stringify(item))}`;
   const text = itemText2(item);
@@ -15899,7 +15950,13 @@ function itemEvents(item, turn, step, requestId, selection = modelSelection(), s
       message: {
         id: id2,
         role: "assistant",
-        content: messageContent(item, `${sessionId}:${id2}`, type === "reasoning" ? "reasoning" : "text", text),
+        content: messageContent(
+          item,
+          `${sessionId}:${id2}`,
+          type === "reasoning" ? "reasoning" : "text",
+          text,
+          type === "agentMessage" ? supplementalImages : []
+        ),
         source: { kind: "model", provider: selection.provider, model: selection.model }
       }
     }
@@ -15931,12 +15988,32 @@ function itemEvents(item, turn, step, requestId, selection = modelSelection(), s
   }];
   return [];
 }
-function messageContent(item, attachmentSeed, fallbackType, fallbackText) {
+function messageContent(item, attachmentSeed, fallbackType, fallbackText, supplementalImages = []) {
   const source = item.content ?? item.input;
   const blocks = contentBlocks(source, attachmentSeed);
-  if (blocks.length > 0) return blocks;
+  const images = contentBlocks(supplementalImages, `${attachmentSeed}:tool-output`);
+  if (blocks.length > 0 || images.length > 0) {
+    return [...blocks.length > 0 ? blocks : [{ type: fallbackType, text: fallbackText ?? "" }], ...images];
+  }
   return [{ type: fallbackType, text: fallbackText ?? "" }];
 }
+function toolOutputImageBlocks(item) {
+  const candidates = [
+    record(item.result).content,
+    record(item.output).content,
+    item.contentItems,
+    Array.isArray(item.output) ? item.output : void 0
+  ];
+  for (const candidate of candidates) {
+    if (!Array.isArray(candidate)) continue;
+    const images = candidate.flatMap((value) => {
+      const block = record(value);
+      return isImageContent2(block) && parseImageBlock(block) !== void 0 ? [block] : [];
+    });
+    if (images.length > 0) return images;
+  }
+  return [];
+}
 function contentBlocks(value, attachmentSeed) {
   if (typeof value === "string") return [{ type: "text", text: value }];
   if (!Array.isArray(value)) return [];
@@ -15991,7 +16068,8 @@ function parseImageBlock(block) {
   if (parsed !== void 0) return parsed;
   const data = string(block.data);
   if (data === void 0 || !isCanonicalBase642(data)) return void 0;
-  const mediaType = string(block.mediaType) ?? sniffImageMediaType2(data);
+  if (data.length > MAX_CODEX_IMAGE_BASE64) return void 0;
+  const mediaType = string(block.mediaType) ?? string(block.mimeType) ?? sniffImageMediaType2(data);
   return mediaType !== void 0 && CODEX_IMAGE_MEDIA_TYPES2.has(mediaType) ? { mediaType, data, url: `data:${mediaType};base64,${data}` } : void 0;
 }
 function parseDataImageUrl2(value) {
@@ -16274,7 +16352,7 @@ function nativeVisibleWorkspaces(catalog, selectedWorkspaceId) {
 function projectWorkspace(project) {
   const root = project.roots[0];
   return {
-    workspaceId: `${CODEX_WORKSPACE_PREFIX}project:${project.id}`,
+    workspaceId: codexProjectWorkspaceId(project.id),
     path: root.path,
     title: project.name.trim() || basename(root.path),
     sessionIds: [],
@@ -16825,7 +16903,7 @@ function normalizeServerUrl(value) {
 }
 
 // src/version.ts
-var PLUGIN_VERSION = "0.4.5";
+var PLUGIN_VERSION = "0.4.7";
 
 // src/server-api.ts
 var TERMINAL_CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f]/u;
@@ -18703,6 +18781,26 @@ var ClientModeRuntime = class {
     this.logger.info("CodeX virtual workspace opened", { targetDeviceId: shortId(remote.target.deviceId) });
     return { ...this.status(), workspace };
   }
+  async createCodexWorkspace(targetDeviceId, path, signal) {
+    const trimmedPath = path.trim();
+    if (trimmedPath === "") throw new ClientModeError("INVALID_MESSAGE", "A CodeX project directory is required.");
+    const remote = await this.ensureConnected(targetDeviceId, signal);
+    remote.features = await probeRemoteHostFeatures(remote.client, remote.clientVersion);
+    if (!remote.features.codex) {
+      throw new ClientModeError("FEATURE_NOT_SUPPORTED", "The selected Host does not provide CodeX workspaces.");
+    }
+    this.assertRemoteCompatible(remote);
+    const result = record2(await new CodexRemoteClient(remote.client).request("project/create", {
+      name: remoteWorkspaceTitle(trimmedPath),
+      roots: [{ path: trimmedPath }],
+      idempotencyKey: uuidV7()
+    }, signal));
+    const project = record2(result.project);
+    if (typeof project.id !== "string" || project.id.length === 0) {
+      throw new ClientModeError("INVALID_MESSAGE", "The Host returned an invalid CodeX project.");
+    }
+    return this.openCodexWorkspace(targetDeviceId, codexProjectWorkspaceId(project.id), signal);
+  }
   consumeWorkspaceSelection(selection) {
     const pending = this.pendingWorkspaceSelection;
     if (pending?.targetDeviceId === selection.targetDeviceId && pending.workspaceId === selection.workspaceId && (pending.backend ?? "harness") === (selection.backend ?? "harness")) {
@@ -18896,7 +18994,7 @@ var ClientModeRuntime = class {
     if (localRemoteGateway && remote.features.remoteGateway || !localRemoteGateway && this.proxySwitch !== void 0 && remote.features.apiProxy) return;
     throw new ClientModeError(
       "HARNESS_VERSION_INCOMPATIBLE",
-      localRemoteGateway ? "The selected Host does not provide the Harness alpha Remote Gateway transport." : "The selected Host does not provide the legacy Harness ApiProxy transport."
+      localRemoteGateway ? "The selected Host does not provide the Harness v0.1.2 Typert Remote Gateway transport." : "The selected Host does not provide the legacy Harness ApiProxy transport."
     );
   }
   async connect(targetDeviceId, signal) {
@@ -19079,6 +19177,13 @@ var ClientModeRuntime = class {
         }
         return ok2(await this.openCodexWorkspace(value.targetDeviceId, value.workspaceId, signal));
       }
+      if (endpoint === "codex.workspace.create") {
+        const value = record2(payload);
+        if (typeof value.targetDeviceId !== "string" || typeof value.path !== "string") {
+          throw new ClientModeError("INVALID_MESSAGE", "A Host and CodeX project directory are required.");
+        }
+        return ok2(await this.createCodexWorkspace(value.targetDeviceId, value.path, signal));
+      }
       if (endpoint === "workspace.selection.consume") {
         const value = record2(payload);
         if (typeof value.targetDeviceId !== "string" || typeof value.workspaceId !== "string") {
@@ -19279,6 +19384,10 @@ function workspaceRecordId(value) {
   }
   return value.workspaceId;
 }
+function remoteWorkspaceTitle(path) {
+  const normalized = path.replace(/[\\/]+$/u, "");
+  return normalized.split(/[\\/]+/u).filter(Boolean).at(-1) ?? path;
+}
 function fail2(error) {
   const source = error instanceof Error ? error : void 0;
   const remoteCode = source !== void 0 && "code" in source && typeof source.code === "string" ? source.code : source instanceof ClientModeError ? source.code : void 0;
@@ -19431,24 +19540,24 @@ var IdentityStore = class {
     }
     if (!hasDevice) {
       const keys = generateKeyPair();
-      const record4 = { schemaVersion: 1, deviceId: uuidV7(), name: deviceName, publicKey: keys.publicKey };
-      await atomicJsonWrite(devicePath, record4, 384);
+      const record5 = { schemaVersion: 1, deviceId: uuidV7(), name: deviceName, publicKey: keys.publicKey };
+      await atomicJsonWrite(devicePath, record5, 384);
       await atomicTextWrite(keyPath, `${keys.privateKey}
 `, 384);
     }
     await assertPrivateMode(keyPath);
     try {
-      let record4 = identitySchema.parse(JSON.parse(await readFile(devicePath, "utf8")));
+      let record5 = identitySchema.parse(JSON.parse(await readFile(devicePath, "utf8")));
       const privateKey = (await readFile(keyPath, "utf8")).trim();
       const regenerated = generateKeyPair(fromBase64Url2(privateKey));
-      if (regenerated.publicKey !== record4.publicKey) {
+      if (regenerated.publicKey !== record5.publicKey) {
         throw new IdentityInvalidError("device public and private keys do not match");
       }
-      if (record4.name !== deviceName) {
-        record4 = { ...record4, name: deviceName };
-        await atomicJsonWrite(devicePath, record4, 384);
+      if (record5.name !== deviceName) {
+        record5 = { ...record5, name: deviceName };
+        await atomicJsonWrite(devicePath, record5, 384);
       }
-      this.identity = { ...record4, privateKey, fingerprint: fingerprint(record4.publicKey) };
+      this.identity = { ...record5, privateKey, fingerprint: fingerprint(record5.publicKey) };
       await this.loadPeers();
       return this.identity;
     } catch (error) {
@@ -19590,10 +19699,10 @@ var ServerCredentialStore = class {
     return parsed.serverUrl === serverUrl && parsed.deviceId === deviceId ? parsed : void 0;
   }
   async save(credentials) {
-    const record4 = credentialSchema.parse({ schemaVersion: 1, ...credentials });
-    await atomicWrite(this.path, `${JSON.stringify(record4, null, 2)}
+    const record5 = credentialSchema.parse({ schemaVersion: 1, ...credentials });
+    await atomicWrite(this.path, `${JSON.stringify(record5, null, 2)}
 `);
-    return record4;
+    return record5;
   }
   async clear() {
     await rm2(this.path, { force: true });
@@ -21395,6 +21504,9 @@ var commandExecuteSchema = external_exports.object({
 var commandListSchema = external_exports.object({
   agentId: external_exports.string().min(1).max(128)
 }).strict();
+var directoryListSchema = external_exports.object({
+  path: external_exports.string().min(1).max(4096).optional()
+}).strict();
 var credentialRefSchema = external_exports.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/, "Invalid credential reference name").max(128);
 var CONFIG_PLANE_SETTINGS_BYTES = 64 * 1024;
 var CONFIG_PLANE_MAX_OPS = 64;
@@ -21524,10 +21636,18 @@ var HarnessApiBridge = class {
   answer;
   async call(input2) {
     const params = callSchema2.parse(input2);
+    const signal = AbortSignal.timeout(NATIVE_CALL_TIMEOUT_MS);
     const method = this.methods.get(params.method);
-    if (method === void 0) throw deniedMethod(params.method);
+    if (method === void 0) {
+      if (params.method === "host.listDirectory") {
+        return this.callDirectoryFallback(params, signal);
+      }
+      if (params.method === "host.describe") {
+        return this.describeFallback(params.rpcId);
+      }
+      throw deniedMethod(params.method);
+    }
     const startedAt = performance.now();
-    const signal = AbortSignal.timeout(NATIVE_CALL_TIMEOUT_MS);
     const request = { rpcId: params.rpcId, payload: params.payload };
     try {
       const callWithTimeout = (overridePayload) => withTimeout(
@@ -21542,12 +21662,10 @@ var HarnessApiBridge = class {
         response = await callWithTimeout(request.payload);
       }
       if (params.method === "host.listDirectory" && needsRemoteDirectoryFallback(response)) {
-        const payload = typeof params.payload === "object" && params.payload !== null ? params.payload : {};
-        const value = await listRemoteDirectory(typeof payload.path === "string" ? payload.path : void 0, signal);
-        response = { rpcId: params.rpcId, result: { ok: true, value } };
+        response = await this.callDirectoryFallback(params, signal);
       }
       if (params.method === "host.describe") {
-        response = normalizeHostDescribe(response, this.harnessVersion, this.methods.has("host.listDirectory"));
+        response = normalizeHostDescribe(response, this.harnessVersion, true);
       }
       this.logger?.debug("harness api call ok", {
         method: params.method,
@@ -21565,6 +21683,26 @@ var HarnessApiBridge = class {
       throw error;
     }
   }
+  async callDirectoryFallback(params, signal) {
+    const payload = directoryListSchema.parse(params.payload);
+    const value = await listRemoteDirectory(payload.path, signal);
+    return { rpcId: params.rpcId, result: { ok: true, value } };
+  }
+  describeFallback(rpcId) {
+    return {
+      rpcId,
+      result: {
+        ok: true,
+        value: {
+          version: this.harnessVersion ?? "0.0.1",
+          cwd: "",
+          home: "",
+          attachedSessions: 0,
+          canOpenPath: true
+        }
+      }
+    };
+  }
   openTransfer(input2) {
     this.pruneTransfers();
     const params = transferOpenSchema.parse(input2);
@@ -22131,6 +22269,9 @@ var transferReadSchema2 = external_exports.object({
   transferId: external_exports.string().uuid(),
   index: external_exports.number().int().nonnegative()
 }).strict();
+var directoryListSchema2 = external_exports.object({
+  path: external_exports.string().min(1).max(4096).optional()
+}).strict();
 var MAX_ACTIVE_STREAMS = 16;
 var MAX_ACTIVE_TRANSFERS = 2;
 var TRANSFER_IDLE_MS = 2 * 6e4;
@@ -22206,15 +22347,29 @@ var HarnessRemoteBridge = class {
   async call(input2) {
     const params = callSchema3.parse(input2);
     this.assertAllowed(params.endpoint);
+    if (params.endpoint === "session/canOpenWorkspacePath") {
+      return { ok: true, value: true };
+    }
     const startedAt = performance.now();
+    const signal = AbortSignal.timeout(6e4);
     try {
-      const result = await this.gateway.dispatch(params.endpoint, params.payload, AbortSignal.timeout(6e4));
+      const nativeResult = await this.gateway.dispatch(params.endpoint, params.payload, signal);
+      const result = params.endpoint === "directoryPicker/list" && needsDirectoryFallback(nativeResult) ? await this.directoryList(params.payload, signal) : nativeResult;
       this.logger?.debug("harness remote call ok", {
         endpoint: params.endpoint,
         durationMs: Math.round(performance.now() - startedAt)
       });
       return result;
     } catch (error) {
+      if (params.endpoint === "directoryPicker/list") {
+        const result = await this.directoryList(params.payload, signal);
+        this.logger?.debug("harness remote call ok", {
+          endpoint: params.endpoint,
+          durationMs: Math.round(performance.now() - startedAt),
+          fallback: "directory-browser"
+        });
+        return result;
+      }
       this.logger?.warn("harness remote call failed", {
         endpoint: params.endpoint,
         durationMs: Math.round(performance.now() - startedAt),
@@ -22223,6 +22378,11 @@ var HarnessRemoteBridge = class {
       throw error;
     }
   }
+  async directoryList(payload, signal) {
+    const args = requestArgs(payload);
+    const params = directoryListSchema2.parse(args);
+    return { ok: true, value: await listRemoteDirectory(params.path, signal) };
+  }
   openTransfer(input2) {
     this.pruneTransfers();
     const params = transferOpenSchema2.parse(input2);
@@ -22406,6 +22566,23 @@ function concatChunks2(chunks, totalBytes) {
   }
   return result;
 }
+function needsDirectoryFallback(result) {
+  if (result.ok) return false;
+  const code = result.error.code.toLocaleLowerCase();
+  const message = result.error.message.toLocaleLowerCase();
+  return code.includes("capability") || code === "directory-picker/unavailable" || code === "directory-picker-unavailable" || message.includes("browse capability") || message.includes("browser capability") || message.includes("brower capability") || message.includes("directory-picker-unavailable");
+}
+function requestArgs(payload) {
+  const root = record4(payload);
+  const args = isRecord7(root.args) ? root.args : root;
+  return record4(args.request ?? args._request ?? args);
+}
+function record4(value) {
+  return isRecord7(value) ? value : {};
+}
+function isRecord7(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 
 // src/codex/domain.ts
 import { randomUUID } from "node:crypto";
@@ -22597,7 +22774,7 @@ var CodexAppServerClient = class {
       this.handleProcessFailure("CODEX_INVALID_RESPONSE", new Error("Codex App Server emitted invalid JSON."));
       return;
     }
-    if (!isRecord7(value)) {
+    if (!isRecord8(value)) {
       this.handleProcessFailure("CODEX_INVALID_RESPONSE", new Error("Codex App Server emitted an invalid message."));
       return;
     }
@@ -22642,12 +22819,12 @@ var CodexAppServerClient = class {
   }
 };
 function safeUpstreamError(value) {
-  if (!isRecord7(value) || typeof value.message !== "string") return "Codex App Server rejected the request.";
+  if (!isRecord8(value) || typeof value.message !== "string") return "Codex App Server rejected the request.";
   const message = value.message.toLowerCase();
   if (message.includes("active writer")) return "Codex thread already has an active writer.";
   return message.includes("not initialized") ? "Codex App Server is not initialized." : "Codex App Server rejected the request.";
 }
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -22669,6 +22846,9 @@ var imageInput = external_exports.object({
 }).strict();
 var input = external_exports.array(external_exports.union([textInput, imageInput])).min(1).max(16);
 var permissionPreset = external_exports.enum(["workspace-write", "danger-full-access"]);
+var projectRoot = external_exports.object({
+  path: external_exports.string().min(1).max(4096)
+}).strict();
 var schemas = {
   "account/read": external_exports.object({ refreshToken: external_exports.literal(false).optional() }).strict(),
   "model/list": external_exports.object({
@@ -22680,6 +22860,11 @@ var schemas = {
     cursor,
     limit: external_exports.number().int().min(1).max(100).optional()
   }).strict(),
+  "project/create": external_exports.object({
+    name: external_exports.string().trim().min(1).max(256),
+    roots: external_exports.array(projectRoot).length(1),
+    idempotencyKey: external_exports.string().min(16).max(256)
+  }).strict(),
   "thread/list": external_exports.object({
     cursor,
     limit: external_exports.number().int().min(1).max(100).optional(),
@@ -23009,15 +23194,15 @@ function decodeCanonicalBase643(value) {
   }
   return decoded;
 }
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function safeErrorCode2(error) {
-  if (isRecord8(error) && typeof error.code === "string") return error.code;
+  if (isRecord9(error) && typeof error.code === "string") return error.code;
   return "UNKNOWN";
 }
 function safeMethod(input2) {
-  return isRecord8(input2) && typeof input2.method === "string" ? input2.method : "invalid";
+  return isRecord9(input2) && typeof input2.method === "string" ? input2.method : "invalid";
 }
 function concatChunks3(chunks, totalBytes) {
   const output = new Uint8Array(totalBytes);
@@ -23101,6 +23286,15 @@ var CodexRemoteDomain = class {
     if (call.method === "project/list") {
       return sanitizeProjectList(await this.callUpstream(call.method, call.params));
     }
+    if (call.method === "project/create") {
+      const roots = call.params.roots;
+      const path = await this.requireNewCodexProjectPath(roots[0].path);
+      return sanitizeProjectCreate(await this.callUpstream(call.method, {
+        name: call.params.name,
+        roots: [{ path }],
+        idempotencyKey: call.params.idempotencyKey
+      }));
+    }
     if (call.method === "thread/list") {
       const result = sanitizeThreadList(await this.callUpstream(call.method, call.params));
       return filterThreadListByWorkspaceAuthority(
@@ -23463,9 +23657,9 @@ var CodexRemoteDomain = class {
         itemsView,
         ...cursor2 === void 0 ? {} : { cursor: cursor2 }
       });
-      const pageResult = isRecord9(result) ? result : {};
+      const pageResult = isRecord10(result) ? result : {};
       for (const rawTurn of array2(pageResult.data)) {
-        if (!isRecord9(rawTurn)) continue;
+        if (!isRecord10(rawTurn)) continue;
         const turnId = typeof rawTurn.id === "string" ? rawTurn.id : void 0;
         const items = rawTurn.itemsView === "full" || turnId === void 0 ? array2(rawTurn.items) : await this.readThreadItems(connectionId, threadId, turnId, array2(rawTurn.items));
         turns.push({ ...rawTurn, items });
@@ -23487,9 +23681,9 @@ var CodexRemoteDomain = class {
           sortDirection: "asc",
           ...cursor2 === void 0 ? {} : { cursor: cursor2 }
         });
-        const pageResult = isRecord9(result) ? result : {};
+        const pageResult = isRecord10(result) ? result : {};
         for (const entry of array2(pageResult.data)) {
-          if (isRecord9(entry) && entry.item !== void 0) items.push(entry.item);
+          if (isRecord10(entry) && entry.item !== void 0) items.push(entry.item);
         }
         cursor2 = typeof pageResult.nextCursor === "string" && pageResult.nextCursor.length > 0 ? pageResult.nextCursor : void 0;
         if (cursor2 === void 0) break;
@@ -23553,7 +23747,7 @@ var CodexRemoteDomain = class {
     return [...this.peers.values()].some((peer) => peer.hasThreadSubscription(threadId));
   }
   resolveUpstreamApproval(params) {
-    if (!isRecord9(params) || typeof params.requestId !== "string" && typeof params.requestId !== "number") return;
+    if (!isRecord10(params) || typeof params.requestId !== "string" && typeof params.requestId !== "number") return;
     for (const [handle, approval] of this.approvals) {
       if (approval.upstreamId === params.requestId) this.approvals.delete(handle);
     }
@@ -23680,6 +23874,18 @@ var CodexRemoteDomain = class {
     }
     throw new RpcError("CODEX_PATH_NOT_ALLOWED", "The CodeX working directory is not available as a Workspace.");
   }
+  async requireNewCodexProjectPath(path) {
+    if (!isAbsolute3(path)) {
+      throw new RpcError("CODEX_PATH_NOT_ALLOWED", "The CodeX project directory must be an existing absolute directory.");
+    }
+    try {
+      const canonical = await realpath(resolve2(path));
+      if (!(await stat4(canonical)).isDirectory()) throw new Error("not a directory");
+      return canonical;
+    } catch {
+      throw new RpcError("CODEX_PATH_NOT_ALLOWED", "The CodeX project directory must be an existing absolute directory.");
+    }
+  }
   async listCodexDirectory(path) {
     const target = await this.resolveCodexDirectory(path);
     const rows = await readdir2(target.path, { withFileTypes: true }).catch(() => void 0);
@@ -23758,24 +23964,24 @@ function codexBinaryCandidates(configured, hostPlatform = process.platform, user
   ])];
 }
 function parseCallEnvelope(input2) {
-  if (!isRecord9(input2) || typeof input2.method !== "string" || !("params" in input2) || Object.keys(input2).some((key) => key !== "method" && key !== "params")) {
+  if (!isRecord10(input2) || typeof input2.method !== "string" || !("params" in input2) || Object.keys(input2).some((key) => key !== "method" && key !== "params")) {
     throw new RpcError("INVALID_MESSAGE", "The Codex call envelope is invalid.");
   }
   return { method: input2.method, params: input2.params };
 }
 function parseRespond(input2) {
-  if (!isRecord9(input2) || typeof input2.requestHandle !== "string" || !["accept", "decline", "cancel"].includes(String(input2.decision)) || Object.keys(input2).some((key) => key !== "requestHandle" && key !== "decision")) {
+  if (!isRecord10(input2) || typeof input2.requestHandle !== "string" || !["accept", "decline", "cancel"].includes(String(input2.decision)) || Object.keys(input2).some((key) => key !== "requestHandle" && key !== "decision")) {
     throw new RpcError("INVALID_MESSAGE", "The Codex approval response is invalid.");
   }
   return input2;
 }
 function accountCanRun(result) {
-  if (!isRecord9(result) || typeof result.requiresOpenaiAuth !== "boolean") return false;
-  return result.requiresOpenaiAuth === false || isRecord9(result.account);
+  if (!isRecord10(result) || typeof result.requiresOpenaiAuth !== "boolean") return false;
+  return result.requiresOpenaiAuth === false || isRecord10(result.account);
 }
 function sanitizeAccount(result) {
-  if (!isRecord9(result)) throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned invalid account state.");
-  const account = isRecord9(result.account) ? result.account : void 0;
+  if (!isRecord10(result)) throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned invalid account state.");
+  const account = isRecord10(result.account) ? result.account : void 0;
   return {
     authenticated: account !== void 0 || result.requiresOpenaiAuth === false,
     requiresOpenaiAuth: result.requiresOpenaiAuth === true,
@@ -23788,11 +23994,11 @@ function sanitizeAccount(result) {
   };
 }
 function sanitizeThreadList(result) {
-  if (!isRecord9(result) || !Array.isArray(result.data)) {
+  if (!isRecord10(result) || !Array.isArray(result.data)) {
     throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned an invalid thread list.");
   }
   const data = result.data.flatMap((value) => {
-    if (!isRecord9(value) || typeof value.id !== "string") return [];
+    if (!isRecord10(value) || typeof value.id !== "string") return [];
     return [{
       id: value.id,
       ...typeof value.sessionId === "string" ? { sessionId: value.sessionId } : {},
@@ -23804,7 +24010,7 @@ function sanitizeThreadList(result) {
       ...typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt) ? { updatedAt: value.updatedAt } : {},
       ...typeof value.archived === "boolean" ? { archived: value.archived } : {},
       ...typeof value.isPinned === "boolean" ? { isPinned: value.isPinned } : {},
-      ...isRecord9(value.status) ? { status: value.status } : {}
+      ...isRecord10(value.status) ? { status: value.status } : {}
     }];
   });
   return {
@@ -23814,39 +24020,47 @@ function sanitizeThreadList(result) {
   };
 }
 function filterThreadListByWorkspaceAuthority(result, authority) {
-  if (!isRecord9(result) || !Array.isArray(result.data)) {
+  if (!isRecord10(result) || !Array.isArray(result.data)) {
     throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned an invalid thread list.");
   }
   return {
     ...result,
-    data: result.data.map((record4) => isRecord9(record4) ? record4 : void 0).filter((thread) => thread !== void 0 && isThreadAllowedByWorkspaceAuthority(thread, authority))
+    data: result.data.map((record5) => isRecord10(record5) ? record5 : void 0).filter((thread) => thread !== void 0 && isThreadAllowedByWorkspaceAuthority(thread, authority))
+  };
+}
+function sanitizeProject(value) {
+  if (!isRecord10(value) || typeof value.id !== "string" || typeof value.name !== "string") return void 0;
+  const roots = Array.isArray(value.roots) ? value.roots.flatMap((root) => {
+    const path = isRecord10(root) && typeof root.path === "string" && root.path.length > 0 ? root.path : void 0;
+    return path === void 0 || !isAbsolute3(path) ? [] : [{ path }];
+  }) : [];
+  if (roots.length === 0) return void 0;
+  return {
+    id: value.id,
+    name: value.name,
+    roots,
+    ...typeof value.position === "number" && Number.isFinite(value.position) ? { position: value.position } : {},
+    ...typeof value.createdAt === "number" && Number.isFinite(value.createdAt) ? { createdAt: value.createdAt } : {},
+    ...typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt) ? { updatedAt: value.updatedAt } : {}
   };
 }
 function sanitizeProjectList(result) {
-  if (!isRecord9(result) || !Array.isArray(result.data)) {
+  if (!isRecord10(result) || !Array.isArray(result.data)) {
     throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned an invalid project list.");
   }
-  const data = result.data.flatMap((value) => {
-    if (!isRecord9(value) || typeof value.id !== "string" || typeof value.name !== "string") return [];
-    const roots = Array.isArray(value.roots) ? value.roots.flatMap((root) => {
-      const path = isRecord9(root) && typeof root.path === "string" && root.path.length > 0 ? root.path : void 0;
-      return path === void 0 || !isAbsolute3(path) ? [] : [{ path }];
-    }) : [];
-    if (roots.length === 0) return [];
-    return [{
-      id: value.id,
-      name: value.name,
-      roots,
-      ...typeof value.position === "number" && Number.isFinite(value.position) ? { position: value.position } : {},
-      ...typeof value.createdAt === "number" && Number.isFinite(value.createdAt) ? { createdAt: value.createdAt } : {},
-      ...typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt) ? { updatedAt: value.updatedAt } : {}
-    }];
-  });
+  const data = result.data.flatMap((value) => sanitizeProject(value) ?? []);
   return {
     data,
     ...typeof result.nextCursor === "string" && result.nextCursor.length > 0 ? { nextCursor: result.nextCursor } : { nextCursor: null }
   };
 }
+function sanitizeProjectCreate(result) {
+  const project = isRecord10(result) ? sanitizeProject(result.project) : void 0;
+  if (project === void 0) {
+    throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned an invalid created project.");
+  }
+  return { project };
+}
 function isThreadAllowedByWorkspaceAuthority(thread, authority) {
   const projectId = typeof thread.projectId === "string" ? thread.projectId : void 0;
   if (projectId !== void 0 && authority.projectIds.has(projectId)) return true;
@@ -23873,19 +24087,19 @@ function codexDirectoryCrumbs(root, path) {
   return crumbs2;
 }
 function extractThread(result) {
-  return isRecord9(result) && isRecord9(result.thread) ? result.thread : void 0;
+  return isRecord10(result) && isRecord10(result.thread) ? result.thread : void 0;
 }
 function extractTurnId(result) {
-  if (!isRecord9(result)) return void 0;
+  if (!isRecord10(result)) return void 0;
   if (typeof result.turnId === "string" && result.turnId.length > 0) return result.turnId;
-  if (isRecord9(result.turn) && typeof result.turn.id === "string" && result.turn.id.length > 0) return result.turn.id;
+  if (isRecord10(result.turn) && typeof result.turn.id === "string" && result.turn.id.length > 0) return result.turn.id;
   return void 0;
 }
 function extractThreadId(params) {
-  if (!isRecord9(params)) return void 0;
+  if (!isRecord10(params)) return void 0;
   if (typeof params.threadId === "string") return params.threadId;
-  if (isRecord9(params.thread) && typeof params.thread.id === "string") return params.thread.id;
-  if (isRecord9(params.turn) && typeof params.turn.threadId === "string") return params.turn.threadId;
+  if (isRecord10(params.thread) && typeof params.thread.id === "string") return params.thread.id;
+  if (isRecord10(params.turn) && typeof params.turn.threadId === "string") return params.turn.threadId;
   return void 0;
 }
 function optionalInteger2(value) {
@@ -23927,13 +24141,13 @@ function mapCodexImageInputs(params) {
   return {
     ...params,
     input: params.input.map((value) => {
-      if (!isRecord9(value) || value.type !== "image" || typeof value.mediaType !== "string" || typeof value.data !== "string") return value;
+      if (!isRecord10(value) || value.type !== "image" || typeof value.mediaType !== "string" || typeof value.data !== "string") return value;
       return { type: "image", url: `data:${value.mediaType};base64,${value.data}` };
     })
   };
 }
 function sanitizeApprovalParams(params, requestHandle) {
-  if (!isRecord9(params)) return { requestHandle };
+  if (!isRecord10(params)) return { requestHandle };
   const safe = { ...params };
   delete safe.proposedExecpolicyAmendment;
   delete safe.additionalPermissions;
@@ -23964,7 +24178,7 @@ function isProjectListFallbackError(error) {
 function canTryNextBinary(error) {
   return !(error instanceof RpcError) || !["CODEX_AUTH_REQUIRED", "CODEX_CLOSED"].includes(error.code);
 }
-function isRecord9(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function array2(value) {