@marktoflow/integrations 2.0.0-alpha.12

package/dist/adapters/github-copilot.d.ts

@@ -0,0 +1,280 @@
+/**
+ * GitHub Copilot SDK Adapter for marktoflow
+ *
+ * This adapter provides deep integration with the GitHub Copilot SDK,
+ * enabling AI-powered workflows with tools, MCP servers, custom agents,
+ * session management, and streaming capabilities.
+ */
+import { type SessionEvent, type ResumeSessionConfig as SDKResumeSessionConfig, type ModelInfo as SDKModelInfo, type SessionMetadata as SDKSessionMetadata } from '@github/copilot-sdk';
+import { SDKInitializer } from '@marktoflow/core';
+type LogLevel = 'info' | 'none' | 'error' | 'warning' | 'debug' | 'all';
+/**
+ * Configuration for creating a GitHubCopilotClient
+ */
+export interface CopilotClientConfig {
+    /** Path to the Copilot CLI executable */
+    cliPath?: string;
+    /** URL of existing Copilot CLI server */
+    cliUrl?: string;
+    /** Default model to use */
+    model?: string;
+    /** Auto-start the CLI server */
+    autoStart?: boolean;
+    /** Log level */
+    logLevel?: LogLevel;
+    /** Working directory */
+    cwd?: string;
+    /** Files to exclude from automatic context loading (e.g., ['CLAUDE.md', 'AGENTS.md']) */
+    excludeFiles?: string[];
+    /** Environment variables */
+    env?: Record<string, string | undefined>;
+}
+/**
+ * File or directory attachment
+ */
+export interface CopilotAttachment {
+    type: 'file' | 'directory';
+    path: string;
+    displayName?: string;
+}
+/**
+ * Tool definition for workflows
+ */
+export interface CopilotToolDefinition {
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+    handler: (args: unknown) => Promise<unknown> | unknown;
+}
+/**
+ * Custom agent configuration for workflows
+ */
+export interface CopilotAgentConfig {
+    name: string;
+    displayName?: string;
+    description?: string;
+    tools?: string[] | null;
+    prompt: string;
+}
+/**
+ * MCP server configuration for workflows
+ */
+export interface CopilotMcpServerConfig {
+    type?: 'local' | 'stdio' | 'http' | 'sse';
+    tools: string[] | '*';
+    command?: string;
+    args?: string[];
+    url?: string;
+    env?: Record<string, string>;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * Configuration for creating a session
+ */
+export interface CopilotSessionConfig {
+    /** Model to use */
+    model?: string;
+    /** Custom system message */
+    systemMessage?: string;
+    /** Enable streaming */
+    streaming?: boolean;
+    /** Tools to expose */
+    tools?: CopilotToolDefinition[];
+    /** MCP server configurations */
+    mcpServers?: Record<string, CopilotMcpServerConfig>;
+    /** Custom agent configurations */
+    customAgents?: CopilotAgentConfig[];
+    /** Available tools whitelist */
+    availableTools?: string[];
+    /** Excluded tools blacklist */
+    excludedTools?: string[];
+    /** Files to exclude from automatic context loading (e.g., ['CLAUDE.md', 'AGENTS.md']) */
+    excludeFiles?: string[];
+}
+/**
+ * Result from a Copilot query
+ */
+export interface CopilotResult {
+    content: string;
+    sessionId: string;
+    events: SessionEvent[];
+    toolRequests?: Array<{
+        toolCallId: string;
+        name: string;
+        arguments?: unknown;
+    }>;
+}
+/**
+ * Streaming callback
+ */
+export type CopilotStreamCallback = (chunk: string, event: SessionEvent) => void | Promise<void>;
+/**
+ * Client for interacting with GitHub Copilot via the SDK
+ *
+ * Provides multiple interfaces for different use cases:
+ * - send(): Simple prompt-response
+ * - stream(): Streaming responses with callbacks
+ * - sendWithSession(): Full session control
+ * - sendWithTools(): Execute with custom tools
+ * - sendWithAgents(): Use custom agents
+ * - sendWithMcp(): Use MCP servers
+ */
+export declare class GitHubCopilotClient {
+    private client;
+    private defaultModel;
+    constructor(config?: CopilotClientConfig);
+    /**
+     * Send a message and wait for the complete response
+     */
+    send(inputs: {
+        prompt: string;
+        model?: string;
+        attachments?: CopilotAttachment[];
+        systemMessage?: string;
+    }): Promise<string>;
+    /**
+     * Send a message and stream the response
+     */
+    stream(inputs: {
+        prompt: string;
+        model?: string;
+        attachments?: CopilotAttachment[];
+        systemMessage?: string;
+        onChunk?: (chunk: string) => void;
+        onComplete?: (fullResponse: string) => void;
+    }): Promise<string>;
+    /**
+     * Send a message with full session configuration
+     */
+    sendWithSession(message: {
+        prompt: string;
+        attachments?: CopilotAttachment[];
+    }, sessionConfig?: CopilotSessionConfig): Promise<CopilotResult>;
+    /**
+     * Send a message with streaming and callbacks
+     */
+    streamWithSession(message: {
+        prompt: string;
+        attachments?: CopilotAttachment[];
+    }, callback: CopilotStreamCallback, sessionConfig?: CopilotSessionConfig): Promise<CopilotResult>;
+    /**
+     * Resume a previous session and send a message
+     */
+    resumeAndSend(sessionId: string, message: {
+        prompt: string;
+        attachments?: CopilotAttachment[];
+    }, config?: SDKResumeSessionConfig): Promise<CopilotResult>;
+    /**
+     * Create a persistent session for multi-turn conversations
+     */
+    createSession(config?: CopilotSessionConfig): Promise<import("@github/copilot-sdk").CopilotSession>;
+    /**
+     * Resume an existing session
+     */
+    resumeSession(sessionId: string, config?: SDKResumeSessionConfig): Promise<import("@github/copilot-sdk").CopilotSession>;
+    /**
+     * Get the most recently updated session ID
+     */
+    getLastSessionId(): Promise<string | undefined>;
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * List all available sessions
+     */
+    listSessions(): Promise<SDKSessionMetadata[]>;
+    /**
+     * Send with custom tools
+     */
+    sendWithTools(message: {
+        prompt: string;
+        attachments?: CopilotAttachment[];
+    }, tools: CopilotToolDefinition[], sessionConfig?: Omit<CopilotSessionConfig, 'tools'>): Promise<CopilotResult>;
+    /**
+     * Send with custom agents
+     */
+    sendWithAgents(message: {
+        prompt: string;
+        attachments?: CopilotAttachment[];
+    }, customAgents: CopilotAgentConfig[], sessionConfig?: Omit<CopilotSessionConfig, 'customAgents'>): Promise<CopilotResult>;
+    /**
+     * Send with MCP servers
+     */
+    sendWithMcp(message: {
+        prompt: string;
+        attachments?: CopilotAttachment[];
+    }, mcpServers: Record<string, CopilotMcpServerConfig>, sessionConfig?: Omit<CopilotSessionConfig, 'mcpServers'>): Promise<CopilotResult>;
+    /**
+     * List available models
+     */
+    listModels(): Promise<SDKModelInfo[]>;
+    /**
+     * Get CLI status
+     */
+    getStatus(): Promise<import("@github/copilot-sdk").GetStatusResponse>;
+    /**
+     * Get authentication status
+     */
+    getAuthStatus(): Promise<import("@github/copilot-sdk").GetAuthStatusResponse>;
+    /**
+     * Ping the CLI server
+     */
+    ping(): Promise<{
+        message: string;
+        timestamp: number;
+    }>;
+    /**
+     * Check if authenticated
+     */
+    checkAuth(): Promise<boolean>;
+    /**
+     * Stop the Copilot CLI client
+     */
+    stop(): Promise<void>;
+    /**
+     * Force stop the CLI client
+     */
+    forceStop(): Promise<void>;
+    /**
+     * Get current connection state
+     */
+    getState(): 'disconnected' | 'connecting' | 'connected' | 'error';
+    /**
+     * Build session configuration from options
+     */
+    private buildSessionConfig;
+    /**
+     * OpenAI-compatible chat interface for workflow compatibility
+     */
+    chat: {
+        completions: (inputs: {
+            model?: string;
+            messages: Array<{
+                role: string;
+                content: string;
+            }>;
+        }) => Promise<{
+            choices: Array<{
+                message: {
+                    content: string;
+                };
+            }>;
+        }>;
+    };
+}
+/**
+ * Create a tool definition with type inference
+ */
+export declare function createCopilotTool<T>(name: string, config: {
+    description?: string;
+    parameters?: Record<string, unknown>;
+    handler: (args: T) => Promise<unknown> | unknown;
+}): CopilotToolDefinition;
+/**
+ * SDK Initializer for GitHub Copilot
+ */
+export declare const GitHubCopilotInitializer: SDKInitializer;
+export type { SessionEvent } from '@github/copilot-sdk';
+//# sourceMappingURL=github-copilot.d.ts.map

package/dist/adapters/github-copilot.d.ts.map

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