dhti-cli 1.2.0 → 1.3.0

package/README.md

@@ -30,6 +30,10 @@ Generative AI features are built as [LangServe Apps](https://python.langchain.co
 #### How (non‑technical / clinical)
 DHTI includes ready‑to‑use [skills](/.github/skills/) that can prompt agentic platforms (e.g., [AntiGravity](https://antigravity.google/), VSCode, or Claude) to generate the GenAI backends and UI components (elixirs and conches) you need. Test these components with synthetic data in OpenMRS or the CDS‑Hooks sandbox, then hand them off to production teams. Because DHTI follows open standards, that handoff (the “valley of death”) becomes smoother and more predictable. Try the [prompts](/.github/skills/start-dhti/examples/e2e-sample.md) in your preferred agentic platform after cloning this repo.
 
+Other skills from the open agent skills ecosystem may be useful too! For example, use `npx skills find clinical trial` to find clinical trial related skills. From the results, you can use `npx skills add <skill-name>` to use the skill in your agentic platform. (e.g.`npx skills add anthropics/healthcare@clinical-trial-protocol-skill`)
+
+**🤖 [AI-Powered Workflow with GitHub Copilot SDK:](/notes/COPILOT.md) - WIP**
+
 ## Try it out
 [[Cheatsheet](/notes/cheatsheet.md) | [Download PDF Cheatsheet](https://nuchange.ca/wp-content/uploads/2026/01/dhti_cheatsheet.pdf)]
 
@@ -113,7 +117,7 @@ You will see the new **patient context aware chatbot** in the patient summary pa
 
 | Why | How |
 | --- | --- |
-| I am a clinician! I have no idea how to build GenAI apps. | ✨ DHTI comes with batteries ([skills](/.github/skills/)) included! Use your preferred agentic platform (e.g., [AntiGravity](https://antigravity.google/), [VSCode with Copilot in agent mode](https://code.visualstudio.com/docs/copilot/overview), Claude, [Cursor](https://cursor.com/) and many other) to generate elixirs and conches from [problem-oriented prompts](/prompts/e2e-sample.md) (most of these platforms have a free tier). Test them using synthetic data in OpenMRS or the CDS-Hooks sandbox, then hand them off to production teams. |
+| I am a clinician! I have no idea how to build GenAI apps. | ✨ DHTI comes with batteries ([skills](/.github/skills/)) included! Use your preferred agentic platform (e.g., [AntiGravity](https://antigravity.google/), [VSCode with Copilot in agent mode](https://code.visualstudio.com/docs/copilot/overview), Claude, [Cursor](https://cursor.com/) and many other) to generate elixirs and conches from [problem-oriented prompts](/prompts/e2e-sample.md) (most of these platforms have a free tier). Test them using synthetic data in OpenMRS or the CDS-Hooks sandbox, then hand them off to production teams. You may find useful skills in the open agent skills ecosystem. `npx skills find clinical trial`|
 | I know LangChain, but I don’t know how to build a chain/agent based on data in our EHR. | [These sample elixirs](https://github.com/dermatologist/dhti-elixir) adopt FHIR and cds-hooks as standards for data retrieval and display. The [base class](https://github.com/dermatologist/dhti-elixir-base) provides reusable artifacts |
 | I need a simple platform for experimenting. | This repository provides  everything to start experimenting fast. The command-line tools help to virtualize and orchestrate your experiments using [Docker](https://www.docker.com/)|
 | I am a UI designer. I want to design helpful UI for real users. | See [these sample conches](https://github.com/dermatologist/openmrs-esm-dhti). It shows how to build interface components (conches) for [OpenMRS](https://openmrs.org/) an open-source EMR used by many. Read more about [OpenMRS UI](https://o3-docs.openmrs.org/) |

package/dist/commands/copilot.d.ts

@@ -0,0 +1,54 @@
+import { Command } from '@oclif/core';
+/**
+ * Copilot command that uses the GitHub Copilot SDK to interact with DHTI
+ * and display results with streaming support.
+ */
+export default class Copilot extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'clear-history': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        model: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        prompt: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        skill: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Detects the appropriate skill based on the prompt content
+     * @param prompt - The user's prompt text
+     * @returns The detected skill name
+     */
+    private detectSkill;
+    /**
+     * Gets the path to the conversation history file
+     * @returns The path to the history file
+     */
+    private getHistoryFilePath;
+    /**
+     * Loads conversation history from file
+     * @returns Array of conversation turns or empty array if no history
+     */
+    private loadConversationHistory;
+    /**
+     * Saves conversation history to file
+     * @param history - Array of conversation turns to save
+     */
+    private saveConversationHistory;
+    /**
+     * Clears the conversation history
+     */
+    private clearConversationHistory;
+    /**
+     * Fetches skill content from GitHub if not available locally
+     * @param skillName - The name of the skill to fetch
+     * @returns The skill content or null if not found
+     */
+    private fetchSkillFromGitHub;
+    /**
+     * Loads skill instructions from local or remote source
+     * @param skillName - The name of the skill to load
+     * @returns The skill content or null if not found
+     */
+    private loadSkill;
+    run(): Promise<void>;
+}

package/dist/commands/copilot.js

@@ -0,0 +1,300 @@
+import { CopilotClient } from '@github/copilot-sdk';
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Copilot command that uses the GitHub Copilot SDK to interact with DHTI
+ * and display results with streaming support.
+ */
+export default class Copilot extends Command {
+    static description = 'Interact with DHTI using GitHub Copilot SDK with streaming responses';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --prompt "Start the DHTI stack with langserve"',
+        '<%= config.bin %> <%= command.id %> --file ./my-prompt.txt --model gpt-4.1',
+        '<%= config.bin %> <%= command.id %> --prompt "Generate a new elixir for patient risk assessment" --skill elixir-generator',
+        '<%= config.bin %> <%= command.id %> --clear-history --prompt "Start fresh conversation"',
+        '<%= config.bin %> <%= command.id %> --clear-history  # Clear history without starting new conversation',
+    ];
+    static flags = {
+        'clear-history': Flags.boolean({
+            default: false,
+            description: 'Clear conversation history and start a new session',
+        }),
+        file: Flags.string({
+            char: 'f',
+            description: 'Path to a file containing the prompt to send to copilot-sdk',
+            exclusive: ['prompt'],
+        }),
+        model: Flags.string({
+            char: 'm',
+            default: 'gpt-4.1',
+            description: 'Model to use for copilot-sdk interactions',
+        }),
+        prompt: Flags.string({
+            char: 'p',
+            description: 'Prompt to send to the copilot-sdk',
+            exclusive: ['file'],
+        }),
+        skill: Flags.string({
+            char: 's',
+            default: 'auto',
+            description: 'Skill to use for copilot-sdk interactions (auto, start-dhti, elixir-generator, conch-generator)',
+        }),
+    };
+    /**
+     * Detects the appropriate skill based on the prompt content
+     * @param prompt - The user's prompt text
+     * @returns The detected skill name
+     */
+    detectSkill(prompt) {
+        const lowerPrompt = prompt.toLowerCase();
+        // Check for elixir-related keywords
+        if (lowerPrompt.includes('elixir') ||
+            lowerPrompt.includes('backend') ||
+            lowerPrompt.includes('langserve') ||
+            lowerPrompt.includes('genai app')) {
+            return 'elixir-generator';
+        }
+        // Check for conch-related keywords
+        if (lowerPrompt.includes('conch') ||
+            lowerPrompt.includes('frontend') ||
+            lowerPrompt.includes('ui') ||
+            lowerPrompt.includes('openmrs')) {
+            return 'conch-generator';
+        }
+        // Default to start-dhti for general setup/orchestration
+        return 'start-dhti';
+    }
+    /**
+     * Gets the path to the conversation history file
+     * @returns The path to the history file
+     */
+    getHistoryFilePath() {
+        const dhtiDir = path.join(os.homedir(), '.dhti');
+        if (!fs.existsSync(dhtiDir)) {
+            fs.mkdirSync(dhtiDir, { recursive: true });
+        }
+        return path.join(dhtiDir, 'copilot-history.json');
+    }
+    /**
+     * Loads conversation history from file
+     * @returns Array of conversation turns or empty array if no history
+     */
+    loadConversationHistory() {
+        try {
+            const historyPath = this.getHistoryFilePath();
+            if (fs.existsSync(historyPath)) {
+                const historyData = fs.readFileSync(historyPath, 'utf8');
+                return JSON.parse(historyData);
+            }
+        }
+        catch (error) {
+            this.warn(chalk.yellow(`Failed to load conversation history: ${error}`));
+        }
+        return [];
+    }
+    /**
+     * Saves conversation history to file
+     * @param history - Array of conversation turns to save
+     */
+    saveConversationHistory(history) {
+        try {
+            const historyPath = this.getHistoryFilePath();
+            fs.writeFileSync(historyPath, JSON.stringify(history, null, 2), 'utf8');
+        }
+        catch (error) {
+            this.warn(chalk.yellow(`Failed to save conversation history: ${error}`));
+        }
+    }
+    /**
+     * Clears the conversation history
+     */
+    clearConversationHistory() {
+        try {
+            const historyPath = this.getHistoryFilePath();
+            if (fs.existsSync(historyPath)) {
+                fs.unlinkSync(historyPath);
+                this.log(chalk.green('✓ Conversation history cleared'));
+            }
+            else {
+                this.log(chalk.yellow('No conversation history to clear'));
+            }
+        }
+        catch (error) {
+            this.warn(chalk.yellow(`Failed to clear conversation history: ${error}`));
+        }
+    }
+    /**
+     * Fetches skill content from GitHub if not available locally
+     * @param skillName - The name of the skill to fetch
+     * @returns The skill content or null if not found
+     */
+    async fetchSkillFromGitHub(skillName) {
+        try {
+            const url = `https://raw.githubusercontent.com/dermatologist/dhti/develop/.agents/skills/${skillName}/SKILL.md`;
+            const response = await fetch(url);
+            if (!response.ok) {
+                return null;
+            }
+            return response.text();
+        }
+        catch (error) {
+            this.warn(`Failed to fetch skill ${skillName} from GitHub: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Loads skill instructions from local or remote source
+     * @param skillName - The name of the skill to load
+     * @returns The skill content or null if not found
+     */
+    async loadSkill(skillName) {
+        // Resolve skills directory
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        const skillsDir = path.resolve(__dirname, '../../.agents/skills');
+        const skillPath = path.join(skillsDir, skillName, 'SKILL.md');
+        // Try to load from local directory first
+        if (fs.existsSync(skillPath)) {
+            try {
+                return fs.readFileSync(skillPath, 'utf8');
+            }
+            catch (error) {
+                this.warn(`Failed to read local skill file: ${error}`);
+            }
+        }
+        // If not found locally, try to fetch from GitHub
+        this.log(chalk.yellow(`Skill ${skillName} not found locally, fetching from GitHub...`));
+        return this.fetchSkillFromGitHub(skillName);
+    }
+    // eslint-disable-next-line perfectionist/sort-classes
+    async run() {
+        const { flags } = await this.parse(Copilot);
+        // Handle clear-history flag
+        if (flags['clear-history']) {
+            this.clearConversationHistory();
+            // If only clearing history, exit after clearing
+            if (!flags.prompt && !flags.file) {
+                return;
+            }
+        }
+        // Validate that either prompt or file is provided
+        if (!flags.prompt && !flags.file) {
+            this.error('Either --prompt or --file must be provided');
+        }
+        // Get the prompt content
+        let promptContent;
+        if (flags.file) {
+            if (!fs.existsSync(flags.file)) {
+                this.error(`File not found: ${flags.file}`);
+            }
+            try {
+                promptContent = fs.readFileSync(flags.file, 'utf8');
+            }
+            catch (error) {
+                this.error(`Failed to read file: ${error}`);
+            }
+        }
+        else {
+            promptContent = flags.prompt;
+        }
+        // Load conversation history
+        const conversationHistory = this.loadConversationHistory();
+        const hasHistory = conversationHistory.length > 0;
+        if (hasHistory) {
+            this.log(chalk.cyan(`📜 Loaded ${conversationHistory.length} previous message(s) from history`));
+        }
+        // Determine which skill to use
+        let skillName = flags.skill;
+        if (skillName === 'auto') {
+            skillName = this.detectSkill(promptContent);
+            this.log(chalk.cyan(`Auto-detected skill: ${skillName}`));
+        }
+        // Load the skill instructions
+        const skillContent = await this.loadSkill(skillName);
+        if (!skillContent) {
+            this.warn(chalk.yellow(`Could not load skill: ${skillName}. Proceeding without skill context.`));
+        }
+        // Build system message with skill instructions
+        let systemMessageContent = 'You are a helpful assistant that can use specific skills to generate components of the DHTI stack based on user prompts.';
+        // Add skill-specific instructions
+        if (skillContent) {
+            systemMessageContent += '\n\n' + skillContent;
+        }
+        // Add default instruction to use start-dhti skill
+        if (skillName !== 'start-dhti') {
+            systemMessageContent += '\n\nNote: If the user needs to start the DHTI stack, use the start-dhti skill workflow.';
+        }
+        // Add conversation history context
+        if (hasHistory) {
+            systemMessageContent += '\n\n## Previous Conversation\n';
+            systemMessageContent += 'Here is the conversation history for context:\n\n';
+            for (const turn of conversationHistory) {
+                systemMessageContent += `${turn.role === 'user' ? 'User' : 'Assistant'}: ${turn.content}\n\n`;
+            }
+            systemMessageContent += 'Continue the conversation naturally based on this context.';
+        }
+        this.log(chalk.green('Initializing GitHub Copilot SDK...'));
+        let client = null;
+        let assistantResponse = '';
+        try {
+            // Create copilot client
+            client = new CopilotClient();
+            // Create a session with streaming enabled
+            const session = await client.createSession({
+                model: flags.model,
+                streaming: true,
+                systemMessage: {
+                    content: systemMessageContent,
+                    mode: 'append',
+                },
+            });
+            this.log(chalk.green(`Using model: ${flags.model}`));
+            this.log(chalk.green(`Using skill: ${skillName}`));
+            this.log(chalk.blue('\n--- Copilot Response ---\n'));
+            // Handle streaming responses
+            let responseStarted = false;
+            session.on('assistant.message_delta', (event) => {
+                if (!responseStarted) {
+                    responseStarted = true;
+                }
+                const content = event.data.deltaContent;
+                process.stdout.write(content);
+                assistantResponse += content;
+            });
+            // Handle session idle (response complete)
+            session.on('session.idle', () => {
+                if (responseStarted) {
+                    console.log('\n'); // Add newline after response
+                }
+            });
+            // Send the prompt and wait for completion
+            await session.sendAndWait({ prompt: promptContent });
+            this.log(chalk.blue('\n--- End of Response ---\n'));
+            // Save conversation history
+            conversationHistory.push({ content: promptContent, role: 'user' });
+            if (assistantResponse.trim()) {
+                conversationHistory.push({ content: assistantResponse.trim(), role: 'assistant' });
+            }
+            this.saveConversationHistory(conversationHistory);
+            this.log(chalk.dim(`💾 Conversation saved (${conversationHistory.length} messages). Use --clear-history to reset.`));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.error(chalk.red(`Failed to interact with Copilot SDK: ${errorMessage}\n\n`) +
+                chalk.yellow('Troubleshooting:\n') +
+                chalk.yellow('1. Ensure GitHub Copilot CLI is installed: https://docs.github.com/en/copilot/using-github-copilot/using-github-copilot-in-the-command-line\n') +
+                chalk.yellow('2. Authenticate with: copilot auth login\n') +
+                chalk.yellow('3. Verify CLI is working: copilot --version\n'));
+        }
+        finally {
+            // Clean up
+            if (client) {
+                await client.stop();
+            }
+        }
+    }
+}

package/oclif.manifest.json

@@ -175,6 +175,80 @@
         "conch.js"
       ]
     },
+    "copilot": {
+      "aliases": [],
+      "args": {},
+      "description": "Interact with DHTI using GitHub Copilot SDK with streaming responses",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --prompt \"Start the DHTI stack with langserve\"",
+        "<%= config.bin %> <%= command.id %> --file ./my-prompt.txt --model gpt-4.1",
+        "<%= config.bin %> <%= command.id %> --prompt \"Generate a new elixir for patient risk assessment\" --skill elixir-generator",
+        "<%= config.bin %> <%= command.id %> --clear-history --prompt \"Start fresh conversation\"",
+        "<%= config.bin %> <%= command.id %> --clear-history  # Clear history without starting new conversation"
+      ],
+      "flags": {
+        "clear-history": {
+          "description": "Clear conversation history and start a new session",
+          "name": "clear-history",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to a file containing the prompt to send to copilot-sdk",
+          "exclusive": [
+            "prompt"
+          ],
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "char": "m",
+          "description": "Model to use for copilot-sdk interactions",
+          "name": "model",
+          "default": "gpt-4.1",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "prompt": {
+          "char": "p",
+          "description": "Prompt to send to the copilot-sdk",
+          "exclusive": [
+            "file"
+          ],
+          "name": "prompt",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skill": {
+          "char": "s",
+          "description": "Skill to use for copilot-sdk interactions (auto, start-dhti, elixir-generator, conch-generator)",
+          "name": "skill",
+          "default": "auto",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "copilot",
+      "pluginAlias": "dhti-cli",
+      "pluginName": "dhti-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "copilot.js"
+      ]
+    },
     "docker": {
       "aliases": [],
       "args": {
@@ -808,5 +882,5 @@
       ]
     }
   },
-  "version": "1.2.0"
+  "version": "1.3.0"
 }

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "dhti-cli",
   "description": "DHTI CLI",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "author": "Bell Eapen",
   "bin": {
     "dhti-cli": "bin/run.js"
   },
   "bugs": "https://github.com/dermatologist/dhti/issues",
   "dependencies": {
+    "@github/copilot-sdk": "^0.1.23",
     "@langchain/community": "^0.3.53",
     "@langchain/ollama": "^0.2.3",
     "@oclif/core": "^4",
@@ -18,7 +19,8 @@
     "js-yaml": "^4.1.0",
     "medpromptjs": ">=0.4.3",
     "ora": "^8.0.1",
-    "request": "^2.88.2"
+    "request": "^2.88.2",
+    "vscode-jsonrpc": "^8.2.1"
   },
   "devDependencies": {
     "@oclif/prettier-config": "^0.2.1",