xcode-copilot-server 3.0.0 → 3.1.0

package/README.md

@@ -1,269 +0,0 @@
-# xcode-copilot-server [![npm version](https://img.shields.io/npm/v/xcode-copilot-server)](https://www.npmjs.com/package/xcode-copilot-server)
-
-A proxy API server that lets you use GitHub Copilot in Xcode, either as a custom model provider or as the backend for Claude Agent and Codex Agent.
-
-## Why
-
-Xcode 26 added support for third-party LLM providers, but it only supports ChatGPT and Claude out of the box. If you have a GitHub Copilot subscription, there's no built-in way to use it.
-
-This server bridges the gap by wrapping the [GitHub Copilot SDK](https://github.com/github/copilot-sdk) and exposing it as an API that Xcode can talk to. It supports three providers:
-
-- **OpenAI** (default): Exposes an OpenAI-compatible completions API so Xcode can use Copilot as a custom model provider. Xcode handles tool execution directly.
-- **Claude**: Exposes an Anthropic-compatible API so Xcode can use Copilot as the backend for Claude Agent. A built-in tool bridge intercepts tool calls and routes them back to Xcode for execution.
-- **Codex**: Exposes an OpenAI Responses-compatible API so Xcode can use Copilot as the backend for Codex Agent. Same tool bridge as Claude.
-
-In OpenAI mode, the server also connects to Xcode's built-in MCP tools (via `xcrun mcpbridge`), giving Copilot access to your project's build logs, indexes and other context. This requires Xcode 26.3 or later. Claude and Codex handle MCP internally through their own agents.
-
-## Installation
-
-You need [Node.js](https://nodejs.org) 25.6.0 or later and a GitHub Copilot subscription. Before starting the server, authenticate using one of the following methods (the Copilot CLI is bundled with the SDK, so you only need one of these for initial sign-in):
-
-- [Install the Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/install-copilot-cli) and run `copilot login`
-- [Install the GitHub CLI](https://cli.github.com/) and run `gh auth login`
-- Set a `GITHUB_TOKEN` environment variable with a valid fine-grained Copilot access token
-
-Then install the server via:
-
-```bash
-npm install -g xcode-copilot-server
-```
-
-Or run it without installing globally:
-
-```bash
-npx xcode-copilot-server
-```
-
-## Usage
-
-```bash
-xcode-copilot-server [options]
-
-Options:
-  -p, --port <number>      Port to listen on (default: 8080)
-  --proxy <provider>       API format: openai, claude, codex (default: openai)
-  -l, --log-level <level>  Log verbosity (default: info)
-  -c, --config <path>      Path to config file
-  --cwd <path>             Working directory for Copilot sessions
-  --auto-patch             Auto-patch settings on start, restore on exit
-  -v, --version            Output the version number
-  -h, --help               Show help
-
-Commands:
-  patch-settings           Patch provider settings and exit (--proxy claude or codex)
-  restore-settings         Restore provider settings from backup and exit
-```
-
-The `--proxy` flag determines which API the server exposes:
-
-| Provider | Flag                       | Routes                                                |
-|----------|----------------------------|-------------------------------------------------------|
-| OpenAI   | `--proxy openai` (default) | `GET /v1/models`, `POST /v1/chat/completions`         |
-| Claude   | `--proxy claude`           | `POST /v1/messages`, `POST /v1/messages/count_tokens` |
-| Codex    | `--proxy codex`            | `POST /v1/responses`                                  |
-
-## Xcode integration
-
-### OpenAI (custom model provider)
-
-1. Start the server: `xcode-copilot-server`
-2. Open Xcode and go to Settings > Intelligence > Add a provider
-3. Select "Locally hosted" and set the port to 8080 (or the port that you've chosen)
-4. Give it a description e.g. "Copilot"
-5. Save
-
-To enable tool calling, select the provider and enable "Allow tools" under "Advanced". To connect Xcode's MCP tools (Xcode 26.3+), enable "Xcode Tools" under "Model Context Protocol".
-
-### Claude (Claude Agent)
-
-1. Open Xcode and go to Settings > Intelligence > Anthropic > Claude Agent
-2. Enable Claude Agent and sign in with an API key (the key can be any random text, since the calls are proxied through the server)
-3. Start the server with `--auto-patch` to automatically configure `settings.json`:
-
-   ```bash
-   xcode-copilot-server --proxy claude --auto-patch
-   ```
-
-   This creates (or updates) `settings.json` at `~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/` to point to the server, and restores the original file when the server shuts down. If `settings.json` already exists, a backup is saved as `settings.json.backup` and restored on exit.
-
-   Alternatively, you can manage `settings.json` yourself. Create it manually at the path above:
-
-   ```json
-   {
-     "env": {
-       "ANTHROPIC_BASE_URL": "http://localhost:8080",
-       "ANTHROPIC_AUTH_TOKEN": "12345"
-     }
-   }
-   ```
-
-   Set the port to match your `--port` flag (default 8080). The auth token can be any non-empty string. Then start the server without `--auto-patch`:
-
-   ```bash
-   xcode-copilot-server --proxy claude
-   ```
-
-   You can also use the `patch-settings` and `restore-settings` subcommands to patch or restore settings without starting the server:
-
-   ```bash
-   xcode-copilot-server patch-settings --proxy claude --port 8080
-   xcode-copilot-server restore-settings --proxy claude
-   ```
-
-The tool bridge is enabled by default for Claude (`toolBridge: true` in the config). It intercepts tool calls from the Copilot session and forwards them to Xcode, so Claude Agent can read files, search code, and make edits through the IDE.
-
-### Codex (Codex Agent)
-
-1. Open Xcode and go to Settings > Intelligence > OpenAI > Codex Agent
-2. Enable Codex Agent and sign in with an API key (the key can be any random text, since the calls are proxied through the server)
-3. Start the server with `--auto-patch` to automatically configure the environment:
-
-   ```bash
-   xcode-copilot-server --proxy codex --auto-patch
-   ```
-
-   This sets `OPENAI_BASE_URL` and `OPENAI_API_KEY` via `launchctl setenv` so Xcode (and any Codex process it spawns) can reach the server. The original values are backed up and restored when the server shuts down. If Xcode was already running, you might need to restart it so it picks up the new environment variables.
-
-   Alternatively, you can set the environment variables yourself via `launchctl`:
-
-   ```bash
-   launchctl setenv OPENAI_BASE_URL http://localhost:8080/v1
-   launchctl setenv OPENAI_API_KEY 12345
-   ```
-
-   Set the port to match your `--port` flag (default 8080). The API key can be any non-empty string. Then start the server without `--auto-patch`:
-
-   ```bash
-   xcode-copilot-server --proxy codex
-   ```
-
-   To restore the original values when you're done:
-
-   ```bash
-   launchctl unsetenv OPENAI_BASE_URL
-   launchctl unsetenv OPENAI_API_KEY
-   ```
-
-   You can also use the `patch-settings` and `restore-settings` subcommands to do this without starting the server:
-
-   ```bash
-   xcode-copilot-server patch-settings --proxy codex --port 8080
-   xcode-copilot-server restore-settings --proxy codex
-   ```
-
-The tool bridge works the same way as Claude, as it intercepts tool calls and routes them back to Xcode for execution.
-
-### Agent skills
-
-[Agent skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) are an open standard for extending AI coding agents with specialised instructions and resources. All three providers support them through the underlying Copilot SDK session, and each agent also has its own skill paths:
-
-| Agent   | Project skills                             | Personal skills        |
-|---------|--------------------------------------------|------------------------|
-| Copilot | `.github/skills/`, `.claude/skills/`       | `~/.copilot/skills/`   |
-| Claude  | `.claude/skills/`                          | `~/.claude/skills/`    |
-| Codex   | `.codex/skills/`                           | `~/.codex/skills/`     |
-
-## Configuration
-
-The server reads its configuration from a `config.json5` file. By default, it uses the bundled one, but you can point to your own with `--config`:
-
-```bash
-xcode-copilot-server --config ./my-config.json5
-```
-
-The config file uses [JSON5](https://json5.org/) format, which supports comments and trailing commas. The `--proxy` flag determines which provider section (`openai`, `claude`, or `codex`) is used at runtime:
-
-```json5
-{
-  openai: {
-    // No tool bridge needed, as Xcode drives tool execution directly.
-    toolBridge: false,
-
-    mcpServers: {
-      // Proxies Apple's xcrun mcpbridge (Xcode 26.3+).
-      xcode: {
-        type: "local",
-        command: "node",
-        args: ["./scripts/mcpbridge-proxy.mjs"],
-        allowedTools: ["*"],
-      },
-    },
-  },
-
-  claude: {
-    // Intercepts tool calls and forwards them to Xcode so Claude Agent
-    // drives tool execution through the IDE instead of the Copilot CLI.
-    toolBridge: true,
-
-    // No MCP servers needed, as Claude Agent handles tools natively.
-    mcpServers: {},
-  },
-
-  codex: {
-    // Same as Claude: intercepts tool calls and forwards them to Xcode
-    // so Codex drives tool execution through the IDE.
-    toolBridge: true,
-
-    mcpServers: {},
-  },
-
-  // Built-in CLI tools allowlist.
-  // ["*"] to allow all, [] to deny all, or a list of specific tool names.
-  //
-  // Empty by default so Xcode can handle all operations (search, read, edit)
-  // through its UI. Enabling CLI tools lets the Copilot session perform
-  // those operations directly, bypassing Xcode.
-  allowedCliTools: [],
-
-  // Maximum request body size in MiB.
-  bodyLimitMiB: 10,
-
-  // Filename patterns to filter out from search results in the prompt.
-  //
-  // Xcode can include full file contents for every search match, so add patterns
-  // here to strip files that bloat the prompt (e.g. ["mock", "generated"]).
-  excludedFilePatterns: [],
-
-  // Reasoning effort for models that support it: "low", "medium", "high", "xhigh"
-  reasoningEffort: "xhigh",
-
-  // Auto-approve permission requests.
-  // true to approve all, false to deny all,
-  // or an array of kinds: "read", "write", "shell", "mcp", "url"
-  autoApprovePermissions: ["read", "mcp"],
-}
-```
-
-## Security
-
-This server acts as a local proxy between Xcode and GitHub Copilot. It's designed to run on your machine and isn't intended to be exposed to the internet or shared networks. So, here's what you should know:
-
-- The server binds to `127.0.0.1`, so it's only reachable from your machine. Incoming requests are checked for expected user-agent headers (`Xcode/` for OpenAI and Codex, `claude-cli/` for Claude), which means casual or accidental connections from other tools will be rejected. This isn't a strong security boundary since user-agent headers can be trivially spoofed, but it helps ensure only the expected client is talking to the server.
-
-- The bundled config sets `autoApprovePermissions` to `["read", "mcp"]`, which lets the Copilot session read files and call MCP tools without prompting. Writes, shell commands, and URL fetches are denied by default. You can set it to `true` to approve everything, `false` to deny everything, or pick specific kinds from `"read"`, `"write"`, `"shell"`, `"mcp"`, and `"url"`.
-
-- MCP servers defined in the config are spawned as child processes. The bundled config uses `xcrun mcpbridge`, which is an Apple-signed binary. If you add your own MCP servers, make sure you trust the commands you're configuring.
-
-## License
-
-MIT License
-
-Copyright (c) 2026 Suyash Srijan
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/config-schema.d.ts

@@ -1,85 +0,0 @@
-import { z } from "zod";
-declare const MCPLocalServerSchema: z.ZodObject<{
-    type: z.ZodUnion<readonly [z.ZodLiteral<"local">, z.ZodLiteral<"stdio">]>;
-    command: z.ZodString;
-    args: z.ZodArray<z.ZodString>;
-    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    cwd: z.ZodOptional<z.ZodString>;
-    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    timeout: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const MCPRemoteServerSchema: z.ZodObject<{
-    type: z.ZodUnion<readonly [z.ZodLiteral<"http">, z.ZodLiteral<"sse">]>;
-    url: z.ZodURL;
-    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    timeout: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const MCPServerSchema: z.ZodUnion<readonly [z.ZodObject<{
-    type: z.ZodUnion<readonly [z.ZodLiteral<"local">, z.ZodLiteral<"stdio">]>;
-    command: z.ZodString;
-    args: z.ZodArray<z.ZodString>;
-    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    cwd: z.ZodOptional<z.ZodString>;
-    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    timeout: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodUnion<readonly [z.ZodLiteral<"http">, z.ZodLiteral<"sse">]>;
-    url: z.ZodURL;
-    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    timeout: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>]>;
-declare const ApprovalRuleSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
-    url: "url";
-    read: "read";
-    write: "write";
-    shell: "shell";
-    mcp: "mcp";
-}>>]>;
-declare const ReasoningEffortSchema: z.ZodEnum<{
-    low: "low";
-    medium: "medium";
-    high: "high";
-    xhigh: "xhigh";
-}>;
-export type MCPLocalServer = z.infer<typeof MCPLocalServerSchema>;
-export type MCPRemoteServer = z.infer<typeof MCPRemoteServerSchema>;
-export type MCPServer = z.infer<typeof MCPServerSchema>;
-export type ApprovalRule = z.infer<typeof ApprovalRuleSchema>;
-export type ReasoningEffort = z.infer<typeof ReasoningEffortSchema>;
-export declare const ServerConfigSchema: z.ZodObject<{
-    mcpServers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
-        type: z.ZodUnion<readonly [z.ZodLiteral<"local">, z.ZodLiteral<"stdio">]>;
-        command: z.ZodString;
-        args: z.ZodArray<z.ZodString>;
-        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        cwd: z.ZodOptional<z.ZodString>;
-        allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodUnion<readonly [z.ZodLiteral<"http">, z.ZodLiteral<"sse">]>;
-        url: z.ZodURL;
-        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>]>>>;
-    allowedCliTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    excludedFilePatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    bodyLimitMiB: z.ZodDefault<z.ZodNumber>;
-    reasoningEffort: z.ZodOptional<z.ZodEnum<{
-        low: "low";
-        medium: "medium";
-        high: "high";
-        xhigh: "xhigh";
-    }>>;
-    autoApprovePermissions: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
-        url: "url";
-        read: "read";
-        write: "write";
-        shell: "shell";
-        mcp: "mcp";
-    }>>]>>;
-}, z.core.$strip>;
-export type RawServerConfig = z.infer<typeof ServerConfigSchema>;
-export {};

package/dist/config-schema.js

@@ -1,38 +0,0 @@
-import { z } from "zod";
-const MCPLocalServerSchema = z.object({
-    type: z.union([z.literal("local"), z.literal("stdio")]),
-    command: z.string().min(1, "MCP server command cannot be empty"),
-    args: z.array(z.string()),
-    env: z.record(z.string(), z.string()).optional(),
-    cwd: z.string().optional(),
-    allowedTools: z.array(z.string()).optional(),
-    timeout: z.number().positive().optional(),
-});
-const MCPRemoteServerSchema = z.object({
-    type: z.union([z.literal("http"), z.literal("sse")]),
-    url: z.url(),
-    headers: z.record(z.string(), z.string()).optional(),
-    allowedTools: z.array(z.string()).optional(),
-    timeout: z.number().positive().optional(),
-});
-const MCPServerSchema = z.union([MCPLocalServerSchema, MCPRemoteServerSchema]);
-const VALID_PERMISSION_KINDS = ["read", "write", "shell", "mcp", "url"];
-const ApprovalRuleSchema = z.union([
-    z.boolean(),
-    z.array(z.enum(VALID_PERMISSION_KINDS)),
-]);
-const VALID_REASONING_EFFORTS = ["low", "medium", "high", "xhigh"];
-const ReasoningEffortSchema = z.enum(VALID_REASONING_EFFORTS);
-export const ServerConfigSchema = z.object({
-    mcpServers: z.record(z.string(), MCPServerSchema).default({}),
-    allowedCliTools: z.array(z.string()).refine((arr) => !arr.includes("*") || arr.length === 1, 'allowedCliTools: use ["*"] alone to allow all tools, don\'t mix with other entries').default([]),
-    excludedFilePatterns: z.array(z.string()).default([]),
-    bodyLimitMiB: z
-        .number()
-        .positive()
-        .max(100, "bodyLimitMiB cannot exceed 100")
-        .default(4),
-    reasoningEffort: ReasoningEffortSchema.optional(),
-    autoApprovePermissions: ApprovalRuleSchema.default(["read", "mcp"]),
-});
-//# sourceMappingURL=config-schema.js.map

package/dist/config-schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../src/config-schema.ts"],"names":[],"mappings":"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"}

package/dist/handlers/completions/session-config.d.ts

@@ -1,12 +0,0 @@
-import type { SessionConfig } from "@github/copilot-sdk";
-import type { ServerConfig } from "../../config.js";
-import type { Logger } from "../../logger.js";
-export interface SessionConfigOptions {
-    model: string;
-    systemMessage?: string | undefined;
-    logger: Logger;
-    config: ServerConfig;
-    supportsReasoningEffort: boolean;
-    cwd?: string | undefined;
-}
-export declare function createSessionConfig({ model, systemMessage, logger, config, supportsReasoningEffort, cwd, }: SessionConfigOptions): SessionConfig;

package/dist/handlers/completions/session-config.js

@@ -1,63 +0,0 @@
-function isApproved(rule, kind) {
-    if (typeof rule === "boolean")
-        return rule;
-    return rule.some((k) => k === kind);
-}
-export function createSessionConfig({ model, systemMessage, logger, config, supportsReasoningEffort, cwd, }) {
-    return {
-        model,
-        streaming: true,
-        infiniteSessions: { enabled: true },
-        workingDirectory: cwd ?? process.cwd(),
-        ...(systemMessage && {
-            systemMessage: {
-                mode: "replace",
-                content: systemMessage,
-            },
-        }),
-        mcpServers: Object.fromEntries(Object.entries(config.mcpServers).map(([name, server]) => [
-            name,
-            { ...server, tools: ["*"] },
-        ])),
-        ...(config.allowedCliTools.length > 0 && {
-            availableTools: config.allowedCliTools,
-        }),
-        ...(config.reasoningEffort && supportsReasoningEffort && {
-            reasoningEffort: config.reasoningEffort,
-        }),
-        onUserInputRequest: (request) => {
-            logger.debug(`User input requested: "${request.question}"`);
-            return Promise.resolve({
-                answer: "User input is not available. Ask your question in your response instead.",
-                wasFreeform: true,
-            });
-        },
-        onPermissionRequest: (request) => {
-            const approved = isApproved(config.autoApprovePermissions, request.kind);
-            logger.debug(`Permission "${request.kind}": ${approved ? "approved" : "denied"}`);
-            return Promise.resolve(approved
-                ? { kind: "approved" }
-                : { kind: "denied-by-rules" });
-        },
-        hooks: {
-            onPreToolUse: (input) => {
-                const toolName = input.toolName;
-                if (config.allowedCliTools.includes("*") ||
-                    config.allowedCliTools.includes(toolName)) {
-                    logger.debug(`Tool "${toolName}": allowed (CLI)`);
-                    return Promise.resolve({ permissionDecision: "allow" });
-                }
-                for (const [serverName, server] of Object.entries(config.mcpServers)) {
-                    const allowlist = server.allowedTools ?? [];
-                    if (allowlist.includes("*") || allowlist.includes(toolName)) {
-                        logger.debug(`Tool "${toolName}": allowed (${serverName})`);
-                        return Promise.resolve({ permissionDecision: "allow" });
-                    }
-                }
-                logger.debug(`Tool "${toolName}": denied (not in any allowlist)`);
-                return Promise.resolve({ permissionDecision: "deny" });
-            },
-        },
-    };
-}
-//# sourceMappingURL=session-config.js.map

package/dist/handlers/completions/session-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-config.js","sourceRoot":"","sources":["../../../src/handlers/completions/session-config.ts"],"names":[],"mappings":"AAaA,SAAS,UAAU,CAAC,IAAkB,EAAE,IAAY;IAClD,IAAI,OAAO,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAClC,KAAK,EACL,aAAa,EACb,MAAM,EACN,MAAM,EACN,uBAAuB,EACvB,GAAG,GACkB;IACrB,OAAO;QACL,KAAK;QACL,SAAS,EAAE,IAAI;QACf,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QACnC,gBAAgB,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QAEtC,GAAG,CAAC,aAAa,IAAI;YACnB,aAAa,EAAE;gBACb,IAAI,EAAE,SAAkB;gBACxB,OAAO,EAAE,aAAa;aACvB;SACF,CAAC;QAEF,UAAU,EAAE,MAAM,CAAC,WAAW,CAC5B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;YACxD,IAAI;YACJ,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE;SAC5B,CAAC,CACH;QAED,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI;YACvC,cAAc,EAAE,MAAM,CAAC,eAAe;SACvC,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,uBAAuB,IAAI;YACvD,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC;QAEF,kBAAkB,EAAE,CAAC,OAAO,EAAE,EAAE;YAC9B,MAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YAC5D,OAAO,OAAO,CAAC,OAAO,CAAC;gBACrB,MAAM,EACJ,0EAA0E;gBAC5E,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,mBAAmB,EAAE,CAAC,OAAO,EAAE,EAAE;YAC/B,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,sBAAsB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACzE,MAAM,CAAC,KAAK,CACV,eAAe,OAAO,CAAC,IAAI,MAAM,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CACpE,CAAC;YACF,OAAO,OAAO,CAAC,OAAO,CACpB,QAAQ;gBACN,CAAC,CAAC,EAAE,IAAI,EAAE,UAAmB,EAAE;gBAC/B,CAAC,CAAC,EAAE,IAAI,EAAE,iBAA0B,EAAE,CACzC,CAAC;QACJ,CAAC;QAED,KAAK,EAAE;YACL,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;gBACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;gBAEhC,IACE,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC;oBACpC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACzC,CAAC;oBACD,MAAM,CAAC,KAAK,CAAC,SAAS,QAAQ,kBAAkB,CAAC,CAAC;oBAClD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,OAAgB,EAAE,CAAC,CAAC;gBACnE,CAAC;gBAED,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBACrE,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;oBAC5C,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC5D,MAAM,CAAC,KAAK,CAAC,SAAS,QAAQ,eAAe,UAAU,GAAG,CAAC,CAAC;wBAC5D,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,OAAgB,EAAE,CAAC,CAAC;oBACnE,CAAC;gBACH,CAAC;gBAED,MAAM,CAAC,KAAK,CAAC,SAAS,QAAQ,kCAAkC,CAAC,CAAC;gBAClE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,MAAe,EAAE,CAAC,CAAC;YAClE,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/handlers/completions/streaming.d.ts

@@ -1,4 +0,0 @@
-import type { FastifyReply } from "fastify";
-import type { CopilotSession } from "@github/copilot-sdk";
-import type { Logger } from "../../logger.js";
-export declare function handleStreaming(reply: FastifyReply, session: CopilotSession, prompt: string, model: string, logger: Logger): Promise<boolean>;

package/dist/handlers/completions/streaming.js

@@ -1,121 +0,0 @@
-import { formatCompaction, SSE_HEADERS } from "../streaming-utils.js";
-import { currentTimestamp } from "../../schemas/openai.js";
-const REQUEST_TIMEOUT_MS = 5 * 60 * 1000;
-export async function handleStreaming(reply, session, prompt, model, logger) {
-    reply.raw.writeHead(200, SSE_HEADERS);
-    const completionId = `chatcmpl-${String(Date.now())}`;
-    function sendChunk(delta, finishReason) {
-        const chunk = {
-            id: completionId,
-            object: "chat.completion.chunk",
-            created: currentTimestamp(),
-            model,
-            choices: [
-                {
-                    index: 0,
-                    delta,
-                    finish_reason: finishReason,
-                },
-            ],
-        };
-        reply.raw.write(`data: ${JSON.stringify(chunk)}\n\n`);
-    }
-    sendChunk({ role: "assistant" }, null);
-    const { promise, resolve } = Promise.withResolvers();
-    let done = false;
-    function cleanup() {
-        done = true;
-        clearTimeout(timeout);
-        unsubscribe();
-    }
-    reply.raw.on("close", () => {
-        if (!done) {
-            logger.info("Client disconnected, aborting session");
-            cleanup();
-            session.abort().catch((err) => {
-                logger.error("Failed to abort session:", err);
-            });
-            resolve(false);
-        }
-    });
-    const timeout = setTimeout(() => {
-        logger.warn("Stream timed out after 5 minutes");
-        cleanup();
-        reply.raw.end();
-        resolve(false);
-    }, REQUEST_TIMEOUT_MS);
-    // buffer deltas so we can drop intermediate narration before tool calls
-    let pendingDeltas = [];
-    const toolNames = new Map();
-    function flushPending() {
-        for (const text of pendingDeltas) {
-            sendChunk({ content: text }, null);
-        }
-        pendingDeltas = [];
-    }
-    const unsubscribe = session.on((event) => {
-        if (event.type === "tool.execution_start") {
-            const d = event.data;
-            toolNames.set(d.toolCallId, d.toolName);
-            logger.debug(`Running ${d.toolName} (${JSON.stringify(d.arguments)})`);
-            return;
-        }
-        if (event.type === "tool.execution_complete") {
-            const d = event.data;
-            const name = toolNames.get(d.toolCallId) ?? d.toolCallId;
-            toolNames.delete(d.toolCallId);
-            const detail = d.success
-                ? JSON.stringify(d.result?.content)
-                : d.error?.message ?? "failed";
-            logger.debug(`${name} done (${detail})`);
-            return;
-        }
-        switch (event.type) {
-            case "assistant.message_delta":
-                if (event.data.deltaContent) {
-                    pendingDeltas.push(event.data.deltaContent);
-                }
-                break;
-            case "assistant.message":
-                if (event.data.toolRequests && event.data.toolRequests.length > 0) {
-                    logger.debug(`Calling tools (dropping buffered text): ${event.data.toolRequests.map((tr) => tr.name).join(", ")}`);
-                    pendingDeltas = [];
-                }
-                else {
-                    flushPending();
-                }
-                break;
-            case "session.idle":
-                logger.info("Done, wrapping up stream");
-                flushPending();
-                cleanup();
-                sendChunk({}, "stop");
-                reply.raw.write("data: [DONE]\n\n");
-                reply.raw.end();
-                resolve(true);
-                break;
-            case "session.compaction_start":
-                logger.info("Compacting context...");
-                break;
-            case "session.compaction_complete":
-                logger.info(`Context compacted: ${formatCompaction(event.data)}`);
-                break;
-            case "session.error":
-                logger.error(`Session error: ${event.data.message}`);
-                cleanup();
-                reply.raw.end();
-                resolve(false);
-                break;
-        }
-    });
-    session.send({ prompt }).catch((err) => {
-        logger.error("Failed to send prompt:", err);
-        if (!done) {
-            cleanup();
-            reply.raw.end();
-        }
-        resolve(false);
-    });
-    return promise;
-}
-//# sourceMappingURL=streaming.js.map

package/dist/handlers/completions/streaming.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../../src/handlers/completions/streaming.ts"],"names":[],"mappings":"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"}

package/dist/handlers/completions.d.ts

@@ -1,4 +0,0 @@
-import type { FastifyRequest, FastifyReply } from "fastify";
-import type { AppContext } from "../context.js";
-import type { ConversationManager } from "../conversation-manager.js";
-export declare function createCompletionsHandler({ service, logger, config }: AppContext, manager: ConversationManager): (request: FastifyRequest, reply: FastifyReply) => Promise<void>;