@limo-labs/deity-adapter-copilot 0.1.0-alpha.1

package/README.md

@@ -0,0 +1,285 @@
+# @limo-labs/deity-adapter-copilot
+
+GitHub Copilot SDK adapter for the Deity framework.
+
+## Overview
+
+This adapter enables Deity agents to use GitHub Copilot's language models (GPT-4o, Claude Opus, o1, etc.) through the Copilot SDK. It implements Deity's `LLMAdapter` interface and handles the conversion between Deity's tool format and Copilot SDK's native tool calling.
+
+## Features
+
+- **Native Tool Support**: Uses Copilot SDK's built-in tool calling for reliable execution
+- **Disposable Sessions**: Creates fresh sessions for each request, optimized for Deity's stateless design
+- **Multiple Models**: Support for GPT-4o, Claude Opus 4.6, o1, o1-mini, and other Copilot-supported models
+- **Tool Call Tracking**: Automatically tracks tool executions via hooks
+- **Environment Isolation**: Blocks environment tools to ensure only registered tools are used
+
+## Installation
+
+```bash
+npm install @limo-labs/deity-adapter-copilot
+```
+
+**Peer Dependencies:**
+- `@limo-labs/deity`: ^0.1.3-alpha.2
+- `@github/copilot-sdk`: ^0.1.25
+
+## Basic Usage
+
+```typescript
+import { CopilotSDKAdapter } from '@limo-labs/deity-adapter-copilot';
+import { Agent, createTool } from '@limo-labs/deity';
+import { z } from 'zod';
+
+// Create adapter
+const adapter = new CopilotSDKAdapter({
+  model: 'claude-opus-4.6',  // or 'gpt-4o', 'o1', etc.
+  debug: true  // Enable logging
+});
+
+// Initialize adapter
+await adapter.initialize();
+
+// Define a tool
+const searchTool = createTool({
+  name: 'search',
+  description: 'Search for information',
+  inputSchema: z.object({
+    query: z.string()
+  }),
+  execute: async (input, ctx) => {
+    // Your search implementation
+    return `Results for: ${input.query}`;
+  }
+});
+
+// Create agent with adapter
+const agent = new Agent({
+  name: 'research-agent',
+  systemPrompt: 'You are a helpful research assistant.',
+  tools: [searchTool],
+  llmAdapter: adapter
+});
+
+// Execute agent
+const result = await agent.execute({
+  input: { topic: 'AI agents' }
+});
+
+// Cleanup
+await adapter.cleanup();
+```
+
+## Configuration Options
+
+```typescript
+interface CopilotSDKAdapterConfig {
+  /**
+   * Model to use (default: 'gpt-4o')
+   * Options: 'gpt-4o', 'claude-opus-4.6', 'o1', 'o1-mini', etc.
+   */
+  model?: string;
+
+  /**
+   * Custom Copilot CLI URL (optional)
+   * If not provided, SDK will auto-manage the CLI
+   */
+  cliUrl?: string;
+
+  /**
+   * Callback for streaming response chunks (optional)
+   */
+  onStreamChunk?: (chunk: string) => void;
+
+  /**
+   * Callback for reasoning/thinking chunks (optional)
+   */
+  onReasoningChunk?: (chunk: string) => void;
+
+  /**
+   * Enable debug logging (default: false)
+   */
+  debug?: boolean;
+}
+```
+
+## Architecture
+
+### Disposable Session Pattern
+
+This adapter uses a **disposable session pattern** optimized for Deity's stateless design:
+
+1. **Create**: A new session is created for each `generate()` call
+2. **Use**: Session executes the request and tool calls
+3. **Destroy**: Session is immediately destroyed in a `finally` block
+
+**Why disposable sessions?**
+
+- Deity uses an intelligent memory system instead of traditional chat history
+- Retaining full chat history consumes significant context with low information density
+- Each request should be self-contained based on dynamically reconstructed context
+- Sessions are lightweight to create/destroy
+
+```typescript
+async generate(messages, tools, config, ctx) {
+  const session = await this.client.createSession({...});
+
+  try {
+    // Execute request
+    const result = await session.sendAndWait({ prompt });
+    return result;
+  } catch (error) {
+    await session.destroy();
+    throw error;
+  } finally {
+    // Always destroy session
+    await session.destroy();
+  }
+}
+```
+
+### Tool Execution Model
+
+The adapter uses Copilot SDK's native tool support:
+
+1. **Registration**: Deity tools are converted to SDK tools using `defineTool()`
+2. **Execution**: SDK handles the tool calling loop automatically
+3. **Tracking**: `onPostToolUse` hook tracks tool calls for Deity compatibility
+4. **Return**: Tool calls are marked as `_alreadyExecuted` to prevent re-execution
+
+```typescript
+// Tool conversion
+const copilotTool = defineTool(tool.name, {
+  description: tool.description,
+  parameters: tool.inputSchema,  // Zod schema (v4 has native toJSONSchema())
+  handler: async (args) => {
+    // Execute Deity tool
+    return await tool.execute(args, ctx);
+  }
+});
+
+// Hook for tracking
+hooks: {
+  onPostToolUse: async (input) => {
+    this.toolCallHistory.push({
+      id: `call_${Date.now()}_${Math.random()}`,
+      name: input.toolName,
+      arguments: input.toolArgs,
+      _alreadyExecuted: true  // Prevent re-execution
+    });
+  }
+}
+```
+
+### Environment Tool Isolation
+
+The adapter excludes all environment tools to ensure only registered tools are used:
+
+```typescript
+excludedTools: [
+  'bash', 'shell', 'view', 'create', 'edit',
+  'web_fetch', 'sql', 'grep', 'glob', 'task',
+  // ... and more
+]
+```
+
+This prevents the LLM from calling tools you haven't explicitly registered.
+
+## Supported Models
+
+- `gpt-4o` (default)
+- `claude-opus-4.6`
+- `o1`
+- `o1-mini`
+- Other models supported by Copilot SDK
+
+## Advanced Usage
+
+### Custom CLI Management
+
+```typescript
+const adapter = new CopilotSDKAdapter({
+  cliUrl: 'http://localhost:9090',  // Custom CLI server
+  model: 'gpt-4o'
+});
+```
+
+### Streaming Responses
+
+```typescript
+const adapter = new CopilotSDKAdapter({
+  model: 'gpt-4o',
+  onStreamChunk: (chunk) => {
+    process.stdout.write(chunk);
+  },
+  onReasoningChunk: (chunk) => {
+    console.log('[Reasoning]', chunk);
+  }
+});
+```
+
+### Debug Logging
+
+```typescript
+const adapter = new CopilotSDKAdapter({
+  debug: true  // Enables detailed logging
+});
+```
+
+## Validation
+
+This adapter has been validated with:
+
+- ✅ Multi-turn tool calling conversations
+- ✅ Long system messages (~20k characters)
+- ✅ Multiple tool registrations (5+ tools)
+- ✅ Complex Zod schemas with nested objects
+- ✅ Error handling and recovery
+
+## Troubleshooting
+
+### Tools not being called
+
+1. Check that `excludedTools` includes environment tools
+2. Verify tool schemas are valid Zod v4 schemas
+3. Enable debug logging to see tool registration
+
+### Session errors
+
+1. Ensure `initialize()` is called before `generate()`
+2. Check that CLI is accessible (if using custom cliUrl)
+3. Verify Copilot SDK is properly installed
+
+### Tool execution failures
+
+1. Check that ExecutionContext is available
+2. Verify tool handler implementation
+3. Enable debug logging to see execution details
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Type check
+npm run type-check
+
+# Lint
+npm run lint
+
+# Test
+npm test
+```
+
+## License
+
+MIT
+
+## Related
+
+- [Deity Framework](https://github.com/limo-labs/deity)
+- [GitHub Copilot SDK](https://github.com/github/copilot-sdk)

package/dist/index.cjs

@@ -0,0 +1,255 @@
+'use strict';
+
+var copilotSdk = require('@github/copilot-sdk');
+
+// src/adapter.ts
+var CopilotSDKAdapter = class {
+  client;
+  model;
+  sessionCounter = 0;
+  isInitialized = false;
+  onStreamChunk;
+  currentContext;
+  debugEnabled;
+  // Track tool calls for Deity compatibility
+  toolCallHistory = [];
+  constructor(config = {}) {
+    this.model = config.model || "gpt-4o";
+    this.onStreamChunk = config.onStreamChunk;
+    this.debugEnabled = config.debug || false;
+    this.client = new copilotSdk.CopilotClient({
+      cliUrl: config.cliUrl,
+      cliArgs: ["--disable-builtin-mcps"]
+    });
+    this.log("CopilotSDKAdapter created:", {
+      model: this.model,
+      mode: config.cliUrl ? "external-server" : "auto-managed",
+      streaming: !!this.onStreamChunk,
+      nativeToolSupport: true
+    });
+  }
+  log(...args) {
+    if (this.debugEnabled) {
+      console.log("[CopilotSDKAdapter]", ...args);
+    }
+  }
+  async initialize() {
+    if (this.isInitialized) {
+      this.log("Client already initialized, skipping");
+      return;
+    }
+    this.log("Starting Copilot client...");
+    await this.client.start();
+    this.isInitialized = true;
+    this.log("Copilot client started successfully");
+  }
+  /**
+   * Generate LLM response using Copilot SDK's native tool support
+   *
+   * Copilot SDK handles:
+   * - Tool definition injection
+   * - Tool call generation
+   * - Tool execution via handlers
+   * - Multi-turn tool calling loop
+   *
+   * Architecture notes:
+   * - Creates a disposable session for each call
+   * - Session is destroyed after use (in finally block)
+   * - Tool calls are tracked via onPostToolUse hook
+   * - Returns toolCalls array marked as already executed
+   */
+  async generate(messages, tools, _config, ctx) {
+    if (!this.isInitialized) {
+      await this.initialize();
+    }
+    this.currentContext = ctx;
+    this.toolCallHistory = [];
+    const startTime = Date.now();
+    const sessionId = `deity-session-${Date.now()}-${this.sessionCounter++}`;
+    this.log("Creating disposable session:", sessionId);
+    const copilotTools = tools ? this.convertTools(tools) : void 0;
+    const toolNames = copilotTools?.map((t) => t.name) || [];
+    this.log("Session tools:", {
+      count: toolNames.length,
+      names: toolNames
+    });
+    const sessionConfig = {
+      sessionId,
+      model: this.model,
+      tools: copilotTools,
+      // Exclude ALL environment tools to ensure only registered tools are used
+      excludedTools: [
+        "bash",
+        "write_bash",
+        "read_bash",
+        "stop_bash",
+        "list_bash",
+        "shell",
+        "view",
+        "create",
+        "edit",
+        "web_fetch",
+        "report_intent",
+        "read_file",
+        "write_file",
+        "sql",
+        "read_agent",
+        "list_agents",
+        "grep",
+        "glob",
+        "task"
+      ],
+      // Add hooks to track tool calls for Deity compatibility
+      hooks: {
+        onPostToolUse: (input) => {
+          const toolCall = {
+            id: `call_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+            name: input.toolName,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+            arguments: input.toolArgs,
+            _alreadyExecuted: true,
+            // Mark as already executed by SDK
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+            _executionResult: JSON.stringify(input.toolResult)
+            // Store result for reference
+          };
+          this.toolCallHistory.push(toolCall);
+          this.log("Tool call tracked:", {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+            name: input.toolName,
+            totalCalls: this.toolCallHistory.length
+          });
+          return void 0;
+        }
+      }
+    };
+    const session = await this.client.createSession(sessionConfig);
+    this.log("Session created:", sessionId);
+    try {
+      const prompt = this.messagesToPrompt(messages);
+      this.log("Sending prompt:", {
+        promptLength: prompt.length,
+        sessionId: session.sessionId,
+        toolsCount: tools?.length || 0
+      });
+      let responseContent = "";
+      try {
+        const result = await session.sendAndWait({ prompt }, 12e6);
+        if (result) {
+          responseContent = result.data.content || "";
+          this.log("Response received:", {
+            length: responseContent.length
+          });
+        }
+      } catch (error) {
+        console.error("[CopilotSDKAdapter] sendAndWait error:", error.message);
+        throw error;
+      }
+      const elapsed = Date.now() - startTime;
+      this.log(`API response received in ${elapsed}ms`);
+      if (this.toolCallHistory.length > 0) {
+        this.log(`Session executed ${this.toolCallHistory.length} tool calls`);
+      }
+      const response = {
+        content: responseContent,
+        toolCalls: this.toolCallHistory.length > 0 ? this.toolCallHistory : void 0
+      };
+      return response;
+    } catch (error) {
+      await session.destroy();
+      throw error;
+    } finally {
+      await session.destroy();
+      this.log("Session destroyed:", sessionId);
+    }
+  }
+  /**
+   * Convert Deity Tool to Copilot SDK Tool using defineTool
+   *
+   * Uses SDK's defineTool() function which properly registers tools.
+   * Zod schemas are passed directly - Zod v4 has native toJSONSchema() method.
+   */
+  convertTools(deityTools) {
+    this.log("Converting Deity tools to Copilot SDK format:", {
+      count: deityTools.length,
+      names: deityTools.map((t) => t.name)
+    });
+    const converted = deityTools.map((tool) => {
+      const parameters = tool.inputSchema;
+      return copilotSdk.defineTool(tool.name, {
+        description: tool.description || `Tool: ${tool.name}`,
+        parameters,
+        handler: async (args) => {
+          this.log("Executing tool via SDK handler:", {
+            name: tool.name
+          });
+          try {
+            if (!this.currentContext) {
+              throw new Error("Execution context not available for tool handler");
+            }
+            const result = await tool.execute(args, this.currentContext);
+            this.log("Tool execution successful:", tool.name);
+            return typeof result === "string" ? result : JSON.stringify(result);
+          } catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            console.error("[CopilotSDKAdapter] Tool execution failed:", {
+              tool: tool.name,
+              error: errorMsg
+            });
+            return JSON.stringify({
+              success: false,
+              error: errorMsg
+            });
+          }
+        }
+      });
+    });
+    this.log("Tool conversion complete:", {
+      convertedCount: converted.length,
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-member-access
+      toolNames: converted.map((t) => t.name || "unknown")
+    });
+    return converted;
+  }
+  /**
+   * Convert Deity messages to Copilot prompt format
+   *
+   * Note: Copilot SDK uses a simple string prompt format.
+   * All message types are concatenated into a single prompt.
+   */
+  messagesToPrompt(messages) {
+    let prompt = "";
+    for (const msg of messages) {
+      switch (msg.role) {
+        case "system":
+          prompt += msg.content + "\n\n";
+          break;
+        case "user":
+          prompt += `User: ${msg.content}
+
+`;
+          break;
+        case "assistant":
+          prompt += `Assistant: ${msg.content}
+
+`;
+          break;
+      }
+    }
+    return prompt;
+  }
+  async cleanup() {
+    if (!this.isInitialized) {
+      return;
+    }
+    this.log("Stopping Copilot client...");
+    await this.client.stop();
+    this.isInitialized = false;
+    this.log("Copilot client stopped");
+  }
+};
+
+exports.CopilotSDKAdapter = CopilotSDKAdapter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapter.ts"],"names":["CopilotClient","defineTool"],"mappings":"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","file":"index.cjs","sourcesContent":["/* eslint-disable @typescript-eslint/no-unsafe-assignment */\n\n/**\n * Copilot SDK Adapter for Deity Framework\n *\n * Uses Copilot SDK's native tool support for reliable tool calling.\n *\n * Architecture:\n * - Deity passes tools to generate()\n * - Adapter converts Deity tools to Copilot SDK tools\n * - Copilot SDK handles tool calling loop automatically\n * - Adapter returns final response with tool call information\n *\n * Session Management:\n * - Uses disposable session pattern (create → use → destroy)\n * - Each generate() call creates a fresh session\n * - Sessions are destroyed in finally block to ensure cleanup\n * - This pattern is optimized for Deity's stateless design\n */\n\nimport { CopilotClient, defineTool, type Tool as CopilotTool } from '@github/copilot-sdk';\nimport type {\n  LLMAdapter,\n  LLMResponse,\n  Message,\n  Tool,\n  GenerationConfig,\n  ExecutionContext,\n  ToolCall,\n} from '@limo-labs/deity';\n\nexport interface CopilotSDKAdapterConfig {\n  /**\n   * Model to use (default: 'gpt-4o')\n   * Options: 'gpt-4o', 'claude-opus-4.6', 'o1', 'o1-mini', etc.\n   */\n  model?: string;\n\n  /**\n   * Custom Copilot CLI URL (optional)\n   * If not provided, SDK will auto-manage the CLI\n   */\n  cliUrl?: string;\n\n  /**\n   * Callback for streaming response chunks (optional)\n   */\n  onStreamChunk?: (chunk: string) => void;\n\n  /**\n   * Callback for reasoning/thinking chunks (optional)\n   */\n  onReasoningChunk?: (chunk: string) => void;\n\n  /**\n   * Enable debug logging (default: false)\n   */\n  debug?: boolean;\n}\n\nexport class CopilotSDKAdapter implements LLMAdapter {\n  private client: CopilotClient;\n  private model: string;\n  private sessionCounter = 0;\n  private isInitialized = false;\n  private onStreamChunk?: (chunk: string) => void;\n  private currentContext?: ExecutionContext;\n  private debugEnabled: boolean;\n\n  // Track tool calls for Deity compatibility\n  private toolCallHistory: ToolCall[] = [];\n\n  constructor(config: CopilotSDKAdapterConfig = {}) {\n    this.model = config.model || 'gpt-4o';\n    this.onStreamChunk = config.onStreamChunk;\n    this.debugEnabled = config.debug || false;\n\n    // CRITICAL FIX: Disable built-in GitHub MCP server\n    // GitHub MCP server auto-activates in git repos and overrides SDK tools\n    this.client = new CopilotClient({\n      cliUrl: config.cliUrl,\n      cliArgs: ['--disable-builtin-mcps'],\n    });\n\n    this.log('CopilotSDKAdapter created:', {\n      model: this.model,\n      mode: config.cliUrl ? 'external-server' : 'auto-managed',\n      streaming: !!this.onStreamChunk,\n      nativeToolSupport: true,\n    });\n  }\n\n  private log(...args: any[]): void {\n    if (this.debugEnabled) {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n      console.log('[CopilotSDKAdapter]', ...args);\n    }\n  }\n\n  async initialize(): Promise<void> {\n    if (this.isInitialized) {\n      this.log('Client already initialized, skipping');\n      return;\n    }\n\n    this.log('Starting Copilot client...');\n    await this.client.start();\n    this.isInitialized = true;\n    this.log('Copilot client started successfully');\n  }\n\n  /**\n   * Generate LLM response using Copilot SDK's native tool support\n   *\n   * Copilot SDK handles:\n   * - Tool definition injection\n   * - Tool call generation\n   * - Tool execution via handlers\n   * - Multi-turn tool calling loop\n   *\n   * Architecture notes:\n   * - Creates a disposable session for each call\n   * - Session is destroyed after use (in finally block)\n   * - Tool calls are tracked via onPostToolUse hook\n   * - Returns toolCalls array marked as already executed\n   */\n  async generate(\n    messages: Message[],\n    tools?: Tool[],\n    _config?: GenerationConfig,\n    ctx?: ExecutionContext\n  ): Promise<LLMResponse> {\n    if (!this.isInitialized) {\n      await this.initialize();\n    }\n\n    // Store context for tool handlers\n    this.currentContext = ctx;\n\n    // Reset tool call history for this generation\n    this.toolCallHistory = [];\n\n    const startTime = Date.now();\n\n    // Disposable session pattern: create new session for each call\n    const sessionId = `deity-session-${Date.now()}-${this.sessionCounter++}`;\n    this.log('Creating disposable session:', sessionId);\n\n    // Convert Deity tools to Copilot SDK tools\n    const copilotTools = tools ? this.convertTools(tools) : undefined;\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-member-access\n    const toolNames = copilotTools?.map((t) => (t as any).name) || [];\n\n    this.log('Session tools:', {\n      count: toolNames.length,\n      names: toolNames,\n    });\n\n    // Create session with hooks to track tool calls\n    const sessionConfig: any = {\n      sessionId,\n      model: this.model,\n      tools: copilotTools,\n      // Exclude ALL environment tools to ensure only registered tools are used\n      excludedTools: [\n        'bash',\n        'write_bash',\n        'read_bash',\n        'stop_bash',\n        'list_bash',\n        'shell',\n        'view',\n        'create',\n        'edit',\n        'web_fetch',\n        'report_intent',\n        'read_file',\n        'write_file',\n        'sql',\n        'read_agent',\n        'list_agents',\n        'grep',\n        'glob',\n        'task',\n      ],\n      // Add hooks to track tool calls for Deity compatibility\n      hooks: {\n        onPostToolUse: (input: any) => {\n          // Record tool call in history with execution metadata\n          const toolCall: any = {\n            id: `call_${Date.now()}_${Math.random().toString(36).slice(2)}`,\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n            name: input.toolName,\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n            arguments: input.toolArgs,\n            _alreadyExecuted: true, // Mark as already executed by SDK\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n            _executionResult: JSON.stringify(input.toolResult), // Store result for reference\n          };\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n          this.toolCallHistory.push(toolCall);\n\n          this.log('Tool call tracked:', {\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n            name: input.toolName,\n            totalCalls: this.toolCallHistory.length,\n          });\n\n          // Don't modify anything, just track\n          return undefined;\n        },\n      },\n    };\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n    const session = await this.client.createSession(sessionConfig);\n    this.log('Session created:', sessionId);\n\n    try {\n      // Convert ALL messages to prompt (including system messages)\n      const prompt = this.messagesToPrompt(messages);\n\n      this.log('Sending prompt:', {\n        promptLength: prompt.length,\n        sessionId: session.sessionId,\n        toolsCount: tools?.length || 0,\n      });\n\n      let responseContent = '';\n\n      // Use sendAndWait() to get the response\n      try {\n        const result = await session.sendAndWait({ prompt }, 12000000); // 12000s timeout\n\n        if (result) {\n          responseContent = result.data.content || '';\n          this.log('Response received:', {\n            length: responseContent.length,\n          });\n        }\n      } catch (error: any) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        console.error('[CopilotSDKAdapter] sendAndWait error:', error.message);\n        throw error;\n      }\n\n      const elapsed = Date.now() - startTime;\n      this.log(`API response received in ${elapsed}ms`);\n\n      if (this.toolCallHistory.length > 0) {\n        this.log(`Session executed ${this.toolCallHistory.length} tool calls`);\n      }\n\n      // Return result with toolCalls marked as already executed\n      // Deity llm-loop will check _alreadyExecuted flag and skip re-execution\n      const response: LLMResponse = {\n        content: responseContent,\n        toolCalls: this.toolCallHistory.length > 0 ? this.toolCallHistory : undefined,\n      };\n\n      return response;\n    } catch (error) {\n      // Clean up session on error\n      await session.destroy();\n      throw error;\n    } finally {\n      // Always destroy disposable session\n      await session.destroy();\n      this.log('Session destroyed:', sessionId);\n    }\n  }\n\n  /**\n   * Convert Deity Tool to Copilot SDK Tool using defineTool\n   *\n   * Uses SDK's defineTool() function which properly registers tools.\n   * Zod schemas are passed directly - Zod v4 has native toJSONSchema() method.\n   */\n  private convertTools(deityTools: Tool[]): CopilotTool[] {\n    this.log('Converting Deity tools to Copilot SDK format:', {\n      count: deityTools.length,\n      names: deityTools.map((t) => t.name),\n    });\n\n    const converted = deityTools.map((tool) => {\n      // Pass Zod schema directly - Zod v4 has native toJSONSchema() method\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n      const parameters = tool.inputSchema as any;\n\n      // Use SDK's defineTool function (critical for proper registration)\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-return\n      return defineTool(tool.name, {\n        description: tool.description || `Tool: ${tool.name}`,\n        parameters,\n        handler: async (args: unknown) => {\n          this.log('Executing tool via SDK handler:', {\n            name: tool.name,\n          });\n\n          try {\n            if (!this.currentContext) {\n              throw new Error('Execution context not available for tool handler');\n            }\n\n            // Execute Deity tool\n            const result = await tool.execute(args, this.currentContext);\n\n            this.log('Tool execution successful:', tool.name);\n\n            // Return result in format expected by Copilot SDK\n            return typeof result === 'string' ? result : JSON.stringify(result);\n          } catch (error) {\n            const errorMsg = error instanceof Error ? error.message : String(error);\n            console.error('[CopilotSDKAdapter] Tool execution failed:', {\n              tool: tool.name,\n              error: errorMsg,\n            });\n\n            // Return error result\n            return JSON.stringify({\n              success: false,\n              error: errorMsg,\n            });\n          }\n        },\n      });\n    });\n\n    this.log('Tool conversion complete:', {\n      convertedCount: converted.length,\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-member-access\n      toolNames: converted.map((t: any) => t.name || 'unknown'),\n    });\n\n    return converted;\n  }\n\n  /**\n   * Convert Deity messages to Copilot prompt format\n   *\n   * Note: Copilot SDK uses a simple string prompt format.\n   * All message types are concatenated into a single prompt.\n   */\n  private messagesToPrompt(messages: Message[]): string {\n    let prompt = '';\n\n    for (const msg of messages) {\n      switch (msg.role) {\n        case 'system':\n          prompt += msg.content + '\\n\\n';\n          break;\n        case 'user':\n          prompt += `User: ${msg.content}\\n\\n`;\n          break;\n        case 'assistant':\n          prompt += `Assistant: ${msg.content}\\n\\n`;\n          break;\n        case 'tool':\n          // Skip tool messages - SDK handles them internally\n          break;\n      }\n    }\n\n    return prompt;\n  }\n\n  async cleanup(): Promise<void> {\n    if (!this.isInitialized) {\n      return;\n    }\n\n    // No sessions to clean up (disposable session pattern)\n    this.log('Stopping Copilot client...');\n    await this.client.stop();\n    this.isInitialized = false;\n    this.log('Copilot client stopped');\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,72 @@
+import { LLMAdapter, Message, Tool, GenerationConfig, ExecutionContext, LLMResponse } from '@limo-labs/deity';
+
+interface CopilotSDKAdapterConfig {
+    /**
+     * Model to use (default: 'gpt-4o')
+     * Options: 'gpt-4o', 'claude-opus-4.6', 'o1', 'o1-mini', etc.
+     */
+    model?: string;
+    /**
+     * Custom Copilot CLI URL (optional)
+     * If not provided, SDK will auto-manage the CLI
+     */
+    cliUrl?: string;
+    /**
+     * Callback for streaming response chunks (optional)
+     */
+    onStreamChunk?: (chunk: string) => void;
+    /**
+     * Callback for reasoning/thinking chunks (optional)
+     */
+    onReasoningChunk?: (chunk: string) => void;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+}
+declare class CopilotSDKAdapter implements LLMAdapter {
+    private client;
+    private model;
+    private sessionCounter;
+    private isInitialized;
+    private onStreamChunk?;
+    private currentContext?;
+    private debugEnabled;
+    private toolCallHistory;
+    constructor(config?: CopilotSDKAdapterConfig);
+    private log;
+    initialize(): Promise<void>;
+    /**
+     * Generate LLM response using Copilot SDK's native tool support
+     *
+     * Copilot SDK handles:
+     * - Tool definition injection
+     * - Tool call generation
+     * - Tool execution via handlers
+     * - Multi-turn tool calling loop
+     *
+     * Architecture notes:
+     * - Creates a disposable session for each call
+     * - Session is destroyed after use (in finally block)
+     * - Tool calls are tracked via onPostToolUse hook
+     * - Returns toolCalls array marked as already executed
+     */
+    generate(messages: Message[], tools?: Tool[], _config?: GenerationConfig, ctx?: ExecutionContext): Promise<LLMResponse>;
+    /**
+     * Convert Deity Tool to Copilot SDK Tool using defineTool
+     *
+     * Uses SDK's defineTool() function which properly registers tools.
+     * Zod schemas are passed directly - Zod v4 has native toJSONSchema() method.
+     */
+    private convertTools;
+    /**
+     * Convert Deity messages to Copilot prompt format
+     *
+     * Note: Copilot SDK uses a simple string prompt format.
+     * All message types are concatenated into a single prompt.
+     */
+    private messagesToPrompt;
+    cleanup(): Promise<void>;
+}
+
+export { CopilotSDKAdapter, type CopilotSDKAdapterConfig };

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+import { LLMAdapter, Message, Tool, GenerationConfig, ExecutionContext, LLMResponse } from '@limo-labs/deity';
+
+interface CopilotSDKAdapterConfig {
+    /**
+     * Model to use (default: 'gpt-4o')
+     * Options: 'gpt-4o', 'claude-opus-4.6', 'o1', 'o1-mini', etc.
+     */
+    model?: string;
+    /**
+     * Custom Copilot CLI URL (optional)
+     * If not provided, SDK will auto-manage the CLI
+     */
+    cliUrl?: string;
+    /**
+     * Callback for streaming response chunks (optional)
+     */
+    onStreamChunk?: (chunk: string) => void;
+    /**
+     * Callback for reasoning/thinking chunks (optional)
+     */
+    onReasoningChunk?: (chunk: string) => void;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+}
+declare class CopilotSDKAdapter implements LLMAdapter {
+    private client;
+    private model;
+    private sessionCounter;
+    private isInitialized;
+    private onStreamChunk?;
+    private currentContext?;
+    private debugEnabled;
+    private toolCallHistory;
+    constructor(config?: CopilotSDKAdapterConfig);
+    private log;
+    initialize(): Promise<void>;
+    /**
+     * Generate LLM response using Copilot SDK's native tool support
+     *
+     * Copilot SDK handles:
+     * - Tool definition injection
+     * - Tool call generation
+     * - Tool execution via handlers
+     * - Multi-turn tool calling loop
+     *
+     * Architecture notes:
+     * - Creates a disposable session for each call
+     * - Session is destroyed after use (in finally block)
+     * - Tool calls are tracked via onPostToolUse hook
+     * - Returns toolCalls array marked as already executed
+     */
+    generate(messages: Message[], tools?: Tool[], _config?: GenerationConfig, ctx?: ExecutionContext): Promise<LLMResponse>;
+    /**
+     * Convert Deity Tool to Copilot SDK Tool using defineTool
+     *
+     * Uses SDK's defineTool() function which properly registers tools.
+     * Zod schemas are passed directly - Zod v4 has native toJSONSchema() method.
+     */
+    private convertTools;
+    /**
+     * Convert Deity messages to Copilot prompt format
+     *
+     * Note: Copilot SDK uses a simple string prompt format.
+     * All message types are concatenated into a single prompt.
+     */
+    private messagesToPrompt;
+    cleanup(): Promise<void>;
+}
+
+export { CopilotSDKAdapter, type CopilotSDKAdapterConfig };

package/dist/index.js

@@ -0,0 +1,253 @@
+import { CopilotClient, defineTool } from '@github/copilot-sdk';
+
+// src/adapter.ts
+var CopilotSDKAdapter = class {
+  client;
+  model;
+  sessionCounter = 0;
+  isInitialized = false;
+  onStreamChunk;
+  currentContext;
+  debugEnabled;
+  // Track tool calls for Deity compatibility
+  toolCallHistory = [];
+  constructor(config = {}) {
+    this.model = config.model || "gpt-4o";
+    this.onStreamChunk = config.onStreamChunk;
+    this.debugEnabled = config.debug || false;
+    this.client = new CopilotClient({
+      cliUrl: config.cliUrl,
+      cliArgs: ["--disable-builtin-mcps"]
+    });
+    this.log("CopilotSDKAdapter created:", {
+      model: this.model,
+      mode: config.cliUrl ? "external-server" : "auto-managed",
+      streaming: !!this.onStreamChunk,
+      nativeToolSupport: true
+    });
+  }
+  log(...args) {
+    if (this.debugEnabled) {
+      console.log("[CopilotSDKAdapter]", ...args);
+    }
+  }
+  async initialize() {
+    if (this.isInitialized) {
+      this.log("Client already initialized, skipping");
+      return;
+    }
+    this.log("Starting Copilot client...");
+    await this.client.start();
+    this.isInitialized = true;
+    this.log("Copilot client started successfully");
+  }
+  /**
+   * Generate LLM response using Copilot SDK's native tool support
+   *
+   * Copilot SDK handles:
+   * - Tool definition injection
+   * - Tool call generation
+   * - Tool execution via handlers
+   * - Multi-turn tool calling loop
+   *
+   * Architecture notes:
+   * - Creates a disposable session for each call
+   * - Session is destroyed after use (in finally block)
+   * - Tool calls are tracked via onPostToolUse hook
+   * - Returns toolCalls array marked as already executed
+   */
+  async generate(messages, tools, _config, ctx) {
+    if (!this.isInitialized) {
+      await this.initialize();
+    }
+    this.currentContext = ctx;
+    this.toolCallHistory = [];
+    const startTime = Date.now();
+    const sessionId = `deity-session-${Date.now()}-${this.sessionCounter++}`;
+    this.log("Creating disposable session:", sessionId);
+    const copilotTools = tools ? this.convertTools(tools) : void 0;
+    const toolNames = copilotTools?.map((t) => t.name) || [];
+    this.log("Session tools:", {
+      count: toolNames.length,
+      names: toolNames
+    });
+    const sessionConfig = {
+      sessionId,
+      model: this.model,
+      tools: copilotTools,
+      // Exclude ALL environment tools to ensure only registered tools are used
+      excludedTools: [
+        "bash",
+        "write_bash",
+        "read_bash",
+        "stop_bash",
+        "list_bash",
+        "shell",
+        "view",
+        "create",
+        "edit",
+        "web_fetch",
+        "report_intent",
+        "read_file",
+        "write_file",
+        "sql",
+        "read_agent",
+        "list_agents",
+        "grep",
+        "glob",
+        "task"
+      ],
+      // Add hooks to track tool calls for Deity compatibility
+      hooks: {
+        onPostToolUse: (input) => {
+          const toolCall = {
+            id: `call_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+            name: input.toolName,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+            arguments: input.toolArgs,
+            _alreadyExecuted: true,
+            // Mark as already executed by SDK
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+            _executionResult: JSON.stringify(input.toolResult)
+            // Store result for reference
+          };
+          this.toolCallHistory.push(toolCall);
+          this.log("Tool call tracked:", {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+            name: input.toolName,
+            totalCalls: this.toolCallHistory.length
+          });
+          return void 0;
+        }
+      }
+    };
+    const session = await this.client.createSession(sessionConfig);
+    this.log("Session created:", sessionId);
+    try {
+      const prompt = this.messagesToPrompt(messages);
+      this.log("Sending prompt:", {
+        promptLength: prompt.length,
+        sessionId: session.sessionId,
+        toolsCount: tools?.length || 0
+      });
+      let responseContent = "";
+      try {
+        const result = await session.sendAndWait({ prompt }, 12e6);
+        if (result) {
+          responseContent = result.data.content || "";
+          this.log("Response received:", {
+            length: responseContent.length
+          });
+        }
+      } catch (error) {
+        console.error("[CopilotSDKAdapter] sendAndWait error:", error.message);
+        throw error;
+      }
+      const elapsed = Date.now() - startTime;
+      this.log(`API response received in ${elapsed}ms`);
+      if (this.toolCallHistory.length > 0) {
+        this.log(`Session executed ${this.toolCallHistory.length} tool calls`);
+      }
+      const response = {
+        content: responseContent,
+        toolCalls: this.toolCallHistory.length > 0 ? this.toolCallHistory : void 0
+      };
+      return response;
+    } catch (error) {
+      await session.destroy();
+      throw error;
+    } finally {
+      await session.destroy();
+      this.log("Session destroyed:", sessionId);
+    }
+  }
+  /**
+   * Convert Deity Tool to Copilot SDK Tool using defineTool
+   *
+   * Uses SDK's defineTool() function which properly registers tools.
+   * Zod schemas are passed directly - Zod v4 has native toJSONSchema() method.
+   */
+  convertTools(deityTools) {
+    this.log("Converting Deity tools to Copilot SDK format:", {
+      count: deityTools.length,
+      names: deityTools.map((t) => t.name)
+    });
+    const converted = deityTools.map((tool) => {
+      const parameters = tool.inputSchema;
+      return defineTool(tool.name, {
+        description: tool.description || `Tool: ${tool.name}`,
+        parameters,
+        handler: async (args) => {
+          this.log("Executing tool via SDK handler:", {
+            name: tool.name
+          });
+          try {
+            if (!this.currentContext) {
+              throw new Error("Execution context not available for tool handler");
+            }
+            const result = await tool.execute(args, this.currentContext);
+            this.log("Tool execution successful:", tool.name);
+            return typeof result === "string" ? result : JSON.stringify(result);
+          } catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            console.error("[CopilotSDKAdapter] Tool execution failed:", {
+              tool: tool.name,
+              error: errorMsg
+            });
+            return JSON.stringify({
+              success: false,
+              error: errorMsg
+            });
+          }
+        }
+      });
+    });
+    this.log("Tool conversion complete:", {
+      convertedCount: converted.length,
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-member-access
+      toolNames: converted.map((t) => t.name || "unknown")
+    });
+    return converted;
+  }
+  /**
+   * Convert Deity messages to Copilot prompt format
+   *
+   * Note: Copilot SDK uses a simple string prompt format.
+   * All message types are concatenated into a single prompt.
+   */
+  messagesToPrompt(messages) {
+    let prompt = "";
+    for (const msg of messages) {
+      switch (msg.role) {
+        case "system":
+          prompt += msg.content + "\n\n";
+          break;
+        case "user":
+          prompt += `User: ${msg.content}
+
+`;
+          break;
+        case "assistant":
+          prompt += `Assistant: ${msg.content}
+
+`;
+          break;
+      }
+    }
+    return prompt;
+  }
+  async cleanup() {
+    if (!this.isInitialized) {
+      return;
+    }
+    this.log("Stopping Copilot client...");
+    await this.client.stop();
+    this.isInitialized = false;
+    this.log("Copilot client stopped");
+  }
+};
+
+export { CopilotSDKAdapter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/* eslint-disable @typescript-eslint/no-unsafe-assignment */\n\n/**\n * Copilot SDK Adapter for Deity Framework\n *\n * Uses Copilot SDK's native tool support for reliable tool calling.\n *\n * Architecture:\n * - Deity passes tools to generate()\n * - Adapter converts Deity tools to Copilot SDK tools\n * - Copilot SDK handles tool calling loop automatically\n * - Adapter returns final response with tool call information\n *\n * Session Management:\n * - Uses disposable session pattern (create → use → destroy)\n * - Each generate() call creates a fresh session\n * - Sessions are destroyed in finally block to ensure cleanup\n * - This pattern is optimized for Deity's stateless design\n */\n\nimport { CopilotClient, defineTool, type Tool as CopilotTool } from '@github/copilot-sdk';\nimport type {\n  LLMAdapter,\n  LLMResponse,\n  Message,\n  Tool,\n  GenerationConfig,\n  ExecutionContext,\n  ToolCall,\n} from '@limo-labs/deity';\n\nexport interface CopilotSDKAdapterConfig {\n  /**\n   * Model to use (default: 'gpt-4o')\n   * Options: 'gpt-4o', 'claude-opus-4.6', 'o1', 'o1-mini', etc.\n   */\n  model?: string;\n\n  /**\n   * Custom Copilot CLI URL (optional)\n   * If not provided, SDK will auto-manage the CLI\n   */\n  cliUrl?: string;\n\n  /**\n   * Callback for streaming response chunks (optional)\n   */\n  onStreamChunk?: (chunk: string) => void;\n\n  /**\n   * Callback for reasoning/thinking chunks (optional)\n   */\n  onReasoningChunk?: (chunk: string) => void;\n\n  /**\n   * Enable debug logging (default: false)\n   */\n  debug?: boolean;\n}\n\nexport class CopilotSDKAdapter implements LLMAdapter {\n  private client: CopilotClient;\n  private model: string;\n  private sessionCounter = 0;\n  private isInitialized = false;\n  private onStreamChunk?: (chunk: string) => void;\n  private currentContext?: ExecutionContext;\n  private debugEnabled: boolean;\n\n  // Track tool calls for Deity compatibility\n  private toolCallHistory: ToolCall[] = [];\n\n  constructor(config: CopilotSDKAdapterConfig = {}) {\n    this.model = config.model || 'gpt-4o';\n    this.onStreamChunk = config.onStreamChunk;\n    this.debugEnabled = config.debug || false;\n\n    // CRITICAL FIX: Disable built-in GitHub MCP server\n    // GitHub MCP server auto-activates in git repos and overrides SDK tools\n    this.client = new CopilotClient({\n      cliUrl: config.cliUrl,\n      cliArgs: ['--disable-builtin-mcps'],\n    });\n\n    this.log('CopilotSDKAdapter created:', {\n      model: this.model,\n      mode: config.cliUrl ? 'external-server' : 'auto-managed',\n      streaming: !!this.onStreamChunk,\n      nativeToolSupport: true,\n    });\n  }\n\n  private log(...args: any[]): void {\n    if (this.debugEnabled) {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n      console.log('[CopilotSDKAdapter]', ...args);\n    }\n  }\n\n  async initialize(): Promise<void> {\n    if (this.isInitialized) {\n      this.log('Client already initialized, skipping');\n      return;\n    }\n\n    this.log('Starting Copilot client...');\n    await this.client.start();\n    this.isInitialized = true;\n    this.log('Copilot client started successfully');\n  }\n\n  /**\n   * Generate LLM response using Copilot SDK's native tool support\n   *\n   * Copilot SDK handles:\n   * - Tool definition injection\n   * - Tool call generation\n   * - Tool execution via handlers\n   * - Multi-turn tool calling loop\n   *\n   * Architecture notes:\n   * - Creates a disposable session for each call\n   * - Session is destroyed after use (in finally block)\n   * - Tool calls are tracked via onPostToolUse hook\n   * - Returns toolCalls array marked as already executed\n   */\n  async generate(\n    messages: Message[],\n    tools?: Tool[],\n    _config?: GenerationConfig,\n    ctx?: ExecutionContext\n  ): Promise<LLMResponse> {\n    if (!this.isInitialized) {\n      await this.initialize();\n    }\n\n    // Store context for tool handlers\n    this.currentContext = ctx;\n\n    // Reset tool call history for this generation\n    this.toolCallHistory = [];\n\n    const startTime = Date.now();\n\n    // Disposable session pattern: create new session for each call\n    const sessionId = `deity-session-${Date.now()}-${this.sessionCounter++}`;\n    this.log('Creating disposable session:', sessionId);\n\n    // Convert Deity tools to Copilot SDK tools\n    const copilotTools = tools ? this.convertTools(tools) : undefined;\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-member-access\n    const toolNames = copilotTools?.map((t) => (t as any).name) || [];\n\n    this.log('Session tools:', {\n      count: toolNames.length,\n      names: toolNames,\n    });\n\n    // Create session with hooks to track tool calls\n    const sessionConfig: any = {\n      sessionId,\n      model: this.model,\n      tools: copilotTools,\n      // Exclude ALL environment tools to ensure only registered tools are used\n      excludedTools: [\n        'bash',\n        'write_bash',\n        'read_bash',\n        'stop_bash',\n        'list_bash',\n        'shell',\n        'view',\n        'create',\n        'edit',\n        'web_fetch',\n        'report_intent',\n        'read_file',\n        'write_file',\n        'sql',\n        'read_agent',\n        'list_agents',\n        'grep',\n        'glob',\n        'task',\n      ],\n      // Add hooks to track tool calls for Deity compatibility\n      hooks: {\n        onPostToolUse: (input: any) => {\n          // Record tool call in history with execution metadata\n          const toolCall: any = {\n            id: `call_${Date.now()}_${Math.random().toString(36).slice(2)}`,\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n            name: input.toolName,\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n            arguments: input.toolArgs,\n            _alreadyExecuted: true, // Mark as already executed by SDK\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n            _executionResult: JSON.stringify(input.toolResult), // Store result for reference\n          };\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n          this.toolCallHistory.push(toolCall);\n\n          this.log('Tool call tracked:', {\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n            name: input.toolName,\n            totalCalls: this.toolCallHistory.length,\n          });\n\n          // Don't modify anything, just track\n          return undefined;\n        },\n      },\n    };\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n    const session = await this.client.createSession(sessionConfig);\n    this.log('Session created:', sessionId);\n\n    try {\n      // Convert ALL messages to prompt (including system messages)\n      const prompt = this.messagesToPrompt(messages);\n\n      this.log('Sending prompt:', {\n        promptLength: prompt.length,\n        sessionId: session.sessionId,\n        toolsCount: tools?.length || 0,\n      });\n\n      let responseContent = '';\n\n      // Use sendAndWait() to get the response\n      try {\n        const result = await session.sendAndWait({ prompt }, 12000000); // 12000s timeout\n\n        if (result) {\n          responseContent = result.data.content || '';\n          this.log('Response received:', {\n            length: responseContent.length,\n          });\n        }\n      } catch (error: any) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        console.error('[CopilotSDKAdapter] sendAndWait error:', error.message);\n        throw error;\n      }\n\n      const elapsed = Date.now() - startTime;\n      this.log(`API response received in ${elapsed}ms`);\n\n      if (this.toolCallHistory.length > 0) {\n        this.log(`Session executed ${this.toolCallHistory.length} tool calls`);\n      }\n\n      // Return result with toolCalls marked as already executed\n      // Deity llm-loop will check _alreadyExecuted flag and skip re-execution\n      const response: LLMResponse = {\n        content: responseContent,\n        toolCalls: this.toolCallHistory.length > 0 ? this.toolCallHistory : undefined,\n      };\n\n      return response;\n    } catch (error) {\n      // Clean up session on error\n      await session.destroy();\n      throw error;\n    } finally {\n      // Always destroy disposable session\n      await session.destroy();\n      this.log('Session destroyed:', sessionId);\n    }\n  }\n\n  /**\n   * Convert Deity Tool to Copilot SDK Tool using defineTool\n   *\n   * Uses SDK's defineTool() function which properly registers tools.\n   * Zod schemas are passed directly - Zod v4 has native toJSONSchema() method.\n   */\n  private convertTools(deityTools: Tool[]): CopilotTool[] {\n    this.log('Converting Deity tools to Copilot SDK format:', {\n      count: deityTools.length,\n      names: deityTools.map((t) => t.name),\n    });\n\n    const converted = deityTools.map((tool) => {\n      // Pass Zod schema directly - Zod v4 has native toJSONSchema() method\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n      const parameters = tool.inputSchema as any;\n\n      // Use SDK's defineTool function (critical for proper registration)\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-return\n      return defineTool(tool.name, {\n        description: tool.description || `Tool: ${tool.name}`,\n        parameters,\n        handler: async (args: unknown) => {\n          this.log('Executing tool via SDK handler:', {\n            name: tool.name,\n          });\n\n          try {\n            if (!this.currentContext) {\n              throw new Error('Execution context not available for tool handler');\n            }\n\n            // Execute Deity tool\n            const result = await tool.execute(args, this.currentContext);\n\n            this.log('Tool execution successful:', tool.name);\n\n            // Return result in format expected by Copilot SDK\n            return typeof result === 'string' ? result : JSON.stringify(result);\n          } catch (error) {\n            const errorMsg = error instanceof Error ? error.message : String(error);\n            console.error('[CopilotSDKAdapter] Tool execution failed:', {\n              tool: tool.name,\n              error: errorMsg,\n            });\n\n            // Return error result\n            return JSON.stringify({\n              success: false,\n              error: errorMsg,\n            });\n          }\n        },\n      });\n    });\n\n    this.log('Tool conversion complete:', {\n      convertedCount: converted.length,\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-member-access\n      toolNames: converted.map((t: any) => t.name || 'unknown'),\n    });\n\n    return converted;\n  }\n\n  /**\n   * Convert Deity messages to Copilot prompt format\n   *\n   * Note: Copilot SDK uses a simple string prompt format.\n   * All message types are concatenated into a single prompt.\n   */\n  private messagesToPrompt(messages: Message[]): string {\n    let prompt = '';\n\n    for (const msg of messages) {\n      switch (msg.role) {\n        case 'system':\n          prompt += msg.content + '\\n\\n';\n          break;\n        case 'user':\n          prompt += `User: ${msg.content}\\n\\n`;\n          break;\n        case 'assistant':\n          prompt += `Assistant: ${msg.content}\\n\\n`;\n          break;\n        case 'tool':\n          // Skip tool messages - SDK handles them internally\n          break;\n      }\n    }\n\n    return prompt;\n  }\n\n  async cleanup(): Promise<void> {\n    if (!this.isInitialized) {\n      return;\n    }\n\n    // No sessions to clean up (disposable session pattern)\n    this.log('Stopping Copilot client...');\n    await this.client.stop();\n    this.isInitialized = false;\n    this.log('Copilot client stopped');\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@limo-labs/deity-adapter-copilot",
+  "version": "0.1.0-alpha.1",
+  "description": "GitHub Copilot SDK adapter for Deity framework",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Limo-Deity/Limo-Deity.git",
+    "directory": "packages/adapter-copilot"
+  },
+  "bugs": {
+    "url": "https://github.com/Limo-Deity/Limo-Deity/issues"
+  },
+  "homepage": "https://github.com/Limo-Deity/Limo-Deity/tree/main/packages/adapter-copilot#readme",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\""
+  },
+  "keywords": [
+    "deity",
+    "adapter",
+    "copilot",
+    "github",
+    "llm",
+    "ai"
+  ],
+  "author": "Limo Labs",
+  "license": "MIT",
+  "peerDependencies": {
+    "@limo-labs/deity": "^0.1.3-alpha.2",
+    "@github/copilot-sdk": "^0.1.25"
+  },
+  "devDependencies": {
+    "@limo-labs/deity": "^0.1.3-alpha.2",
+    "@github/copilot-sdk": "^0.1.25",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "@vitest/coverage-v8": "^1.2.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.2.4",
+    "tsup": "^8.0.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}