xcode-copilot-server 1.0.0

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAiC,MAAM,SAAS,CAAC;AACxD,OAAO,IAAI,MAAM,eAAe,CAAC;AAGjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,UAAU,GAA6B;IAC3C,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAe;IAEf,MAAM,GAAG,GAAG,OAAO,CAAC;QAClB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS;QAC/B,MAAM,EAAE;YACN,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;SACpC;KACF,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC;QACnC,cAAc,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;KAClD,CAAC,CAAC;IAEH,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAChD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,gDAAgD,EAAE,EAAE,CACrD,CAAC;YACF,KAAK,KAAK;iBACP,IAAI,CAAC,GAAG,CAAC;iBACT,IAAI,CAAC,kBAAkB,CAAC;iBACxB,IAAI,CAAC,yBAAyB,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QAED,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhE,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+export interface ContentPart {
+    type: string;
+    text?: string | undefined;
+}
+export type MessageContent = string | ContentPart[] | null;
+export interface ToolCallFunction {
+    name: string;
+    arguments: string;
+}
+export interface ToolCall {
+    index?: number | undefined;
+    id?: string | undefined;
+    type?: string | undefined;
+    function: ToolCallFunction;
+}
+export interface Message {
+    role?: "system" | "developer" | "user" | "assistant" | "tool" | undefined;
+    content?: MessageContent | undefined;
+    name?: string | undefined;
+    tool_calls?: ToolCall[] | undefined;
+    tool_call_id?: string | undefined;
+}
+export interface ToolFunction {
+    name: string;
+    description?: string | undefined;
+    parameters?: Record<string, unknown> | undefined;
+}
+export interface Tool {
+    type: string;
+    function: ToolFunction;
+}
+export interface ChatCompletionRequest {
+    model: string;
+    messages: Message[];
+    temperature?: number | undefined;
+    top_p?: number | undefined;
+    n?: number | undefined;
+    stop?: string | string[] | undefined;
+    max_tokens?: number | undefined;
+    presence_penalty?: number | undefined;
+    frequency_penalty?: number | undefined;
+    tools?: Tool[] | undefined;
+    tool_choice?: unknown;
+    user?: string | undefined;
+}
+export interface Choice {
+    index: number;
+    message?: Message | undefined;
+    delta?: Partial<Message> | undefined;
+    finish_reason: string | null;
+}
+export interface Usage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+export interface ChatCompletionChunk {
+    id: string;
+    object: "chat.completion.chunk";
+    created: number;
+    model: string;
+    choices: Choice[];
+    system_fingerprint?: string | undefined;
+}
+export interface Model {
+    id: string;
+    object: "model";
+    created: number;
+    owned_by: string;
+}
+export interface ModelsResponse {
+    object: "list";
+    data: Model[];
+}
+export interface ErrorDetail {
+    message: string;
+    type: "invalid_request_error" | "api_error";
+    param?: string | null | undefined;
+    code?: string | null | undefined;
+}
+export interface ErrorResponse {
+    error: ErrorDetail;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/prompt.d.ts

@@ -0,0 +1,10 @@
+import type { Message } from "../types.js";
+/**
+ * Strips fenced code blocks whose filename matches any pattern.
+ *
+ * Xcode search dumps full file contents for every match — excluded files
+ * can be thousands of lines and add nothing useful to the prompt.
+ */
+export declare function filterExcludedFiles(s: string, patterns: string[]): string;
+/** System/developer messages are skipped — they're passed via `SessionConfig.systemMessage`. */
+export declare function formatPrompt(messages: Message[], excludedFilePatterns: string[]): string;

package/dist/utils/prompt.js

@@ -0,0 +1,48 @@
+import { extractContentText } from "../schemas.js";
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Strips fenced code blocks whose filename matches any pattern.
+ *
+ * Xcode search dumps full file contents for every match — excluded files
+ * can be thousands of lines and add nothing useful to the prompt.
+ */
+export function filterExcludedFiles(s, patterns) {
+    if (patterns.length === 0)
+        return s;
+    const joined = patterns.map(escapeRegex).join("|");
+    const re = new RegExp("```\\w*:[^\\n]*(?:" + joined + ")[^\\n]*\\n.*?\\n```\\n?", "gis");
+    return s.replace(re, "");
+}
+/** System/developer messages are skipped — they're passed via `SessionConfig.systemMessage`. */
+export function formatPrompt(messages, excludedFilePatterns) {
+    const parts = [];
+    for (const msg of messages) {
+        const content = extractContentText(msg.content);
+        switch (msg.role) {
+            case "system":
+            case "developer":
+                // Handled via SessionConfig.systemMessage
+                continue;
+            case "user":
+                parts.push(`[User]: ${filterExcludedFiles(content, excludedFilePatterns)}`);
+                break;
+            case "assistant":
+                if (content) {
+                    parts.push(`[Assistant]: ${content}`);
+                }
+                if (msg.tool_calls) {
+                    for (const tc of msg.tool_calls) {
+                        parts.push(`[Assistant called tool ${tc.function.name} with args: ${tc.function.arguments}]`);
+                    }
+                }
+                break;
+            case "tool":
+                parts.push(`[Tool result for ${msg.tool_call_id ?? "unknown"}]: ${content}`);
+                break;
+        }
+    }
+    return parts.join("\n\n");
+}
+//# sourceMappingURL=prompt.js.map

package/dist/utils/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAS,EAAE,QAAkB;IAC/D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEpC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,IAAI,MAAM,CACnB,oBAAoB,GAAG,MAAM,GAAG,0BAA0B,EAC1D,KAAK,CACN,CAAC;IACF,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,YAAY,CAC1B,QAAmB,EACnB,oBAA8B;IAE9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEhD,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,QAAQ,CAAC;YACd,KAAK,WAAW;gBACd,0CAA0C;gBAC1C,SAAS;YAEX,KAAK,MAAM;gBACT,KAAK,CAAC,IAAI,CAAC,WAAW,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,CAAC,EAAE,CAAC,CAAC;gBAC5E,MAAM;YAER,KAAK,WAAW;gBACd,IAAI,OAAO,EAAE,CAAC;oBACZ,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;gBACxC,CAAC;gBACD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;oBACnB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;wBAChC,KAAK,CAAC,IAAI,CACR,0BAA0B,EAAE,CAAC,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC,QAAQ,CAAC,SAAS,GAAG,CAClF,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,MAAM;YAER,KAAK,MAAM;gBACT,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,YAAY,IAAI,SAAS,MAAM,OAAO,EAAE,CAAC,CAAC;gBAC7E,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "xcode-copilot-server",
+  "version": "1.0.0",
+  "description": "OpenAI-compatible proxy API server for Xcode, powered by GitHub Copilot",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/theblixguy/xcode-copilot-server.git"
+  },
+"engines": {
+    "node": "25.6.0"
+  },
+  "bin": {
+    "xcode-copilot-server": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "config.json5",
+    "scripts/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@fastify/cors": "11.2.0",
+    "@github/copilot-sdk": "0.1.23",
+    "fastify": "5.7.4",
+    "json5": "2.2.3",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.2",
+    "@types/node": "25.2.1",
+    "eslint": "9.39.2",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.54.0",
+    "vitest": "4.0.18"
+  }
+}

package/scripts/mcpbridge-proxy.mjs

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+/**
+ * MCP stdio proxy for Apple's `xcrun mcpbridge`.
+ *
+ * mcpbridge declares output schemas on its tools but returns
+ * results via the `content` field (text array) without the corresponding
+ * `structuredContent` field that the MCP spec requires. The Copilot CLI
+ * enforces this strictly and rejects the response with error -32600.
+ *
+ * So, intercept every JSON-RPC response from mcpbridge. When a response
+ * carries `content` but no `structuredContent`, synthesise it from the
+ * first text content item — parsing as JSON when possible, falling back
+ * to a `{ text }` wrapper otherwise.
+ * 
+ * Source: https://rudrank.com/exploring-xcode-using-mcp-tools-cursor-external-clients
+ */
+
+import { spawn, execFile } from "node:child_process";
+import { createInterface } from "node:readline";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+
+function patchIfNeeded(msg) {
+  const result = msg.result;
+  if (!result || typeof result !== "object") return;
+  if (!Array.isArray(result.content) || result.content.length === 0) return;
+  if (result.structuredContent !== undefined) return;
+
+  const textItem = result.content.find((c) => c.type === "text");
+  if (!textItem?.text) return;
+
+  try {
+    result.structuredContent = JSON.parse(textItem.text);
+  } catch {
+    result.structuredContent = { text: textItem.text };
+  }
+}
+
+try {
+  await execFileAsync("xcrun", ["--find", "mcpbridge"]);
+} catch (err) {
+  console.error(
+    "Error: xcrun mcpbridge not found. This requires Xcode 26.3 or later."
+  );
+  console.error(
+    "Please install Xcode 26.3+ or remove the 'xcode' MCP server from config.json5"
+  );
+  process.exit(1);
+}
+
+const bridge = spawn("xcrun", ["mcpbridge", ...process.argv.slice(2)], {
+  stdio: ["pipe", "pipe", "inherit"],
+});
+
+process.stdin.pipe(bridge.stdin);
+
+const reader = createInterface({ input: bridge.stdout, crlfDelay: Infinity });
+
+reader.on("line", (line) => {
+  try {
+    const msg = JSON.parse(line);
+    patchIfNeeded(msg);
+    process.stdout.write(JSON.stringify(msg) + "\n");
+  } catch {
+    process.stdout.write(line + "\n");
+  }
+});
+
+bridge.on("exit", (code) => process.exit(code ?? 0));
+process.on("SIGTERM", () => bridge.kill("SIGTERM"));
+process.on("SIGINT", () => bridge.kill("SIGINT"));