dhti-cli 1.3.1 → 1.3.3

package/README.md

@@ -14,7 +14,7 @@
 > 🚀 Dhanvantari rose out of the water with his four hands, holding a pot full of elixirs.
 
 # DHTI
-*DHTI enables rapid prototyping, sharing, and testing of GenAI healthcare applications inside an EHR, helping experiments move smoothly into practice. DHTI also includes [skills](/.github/skills/) that generate GenAI components from problem‑oriented [prompts](/prompts/e2e-sample.md).*
+*DHTI enables rapid prototyping, sharing, and testing of GenAI healthcare applications inside an EHR, helping experiments move smoothly into practice. DHTI also includes [skills](/.agents/skills/) that generate GenAI components from problem‑oriented [prompts](/.agents/skills/start-dhti/examples/e2e-sample.md).*
 
 ### Why?
 
@@ -32,7 +32,12 @@ DHTI includes ready‑to‑use [skills](/.agents/skills/) that can prompt agenti
 
 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**
+## **🤖 [AI-Powered Workflow with GitHub Copilot SDK:](/notes/COPILOT.md) - WIP**
+### Quick example
+```bash
+npx dhti-cli copilot --model gpt-5.3-codex --skill elixir-generator --prompt "Generate an elixir glycemic_advisor that summarizes diabetic patients' latest lab results and medications"
+npx dhti-cli copilot --model gpt-5.3-codex --skill start-dhti --prompt "Start the glycemic_advisor elixir and display in CDS-Hooks sandbox"
+```
 
 ## Try it out
 [[Cheatsheet](/notes/cheatsheet.md) | [Download PDF Cheatsheet](https://nuchange.ca/wp-content/uploads/2026/01/dhti_cheatsheet.pdf)]

package/dist/commands/copilot.d.ts

@@ -12,13 +12,25 @@ export default class Copilot extends Command {
         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>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
     };
+    run(): Promise<void>;
+    /**
+     * Clears the conversation history
+     */
+    private clearConversationHistory;
     /**
      * Detects the appropriate skill based on the prompt content
      * @param prompt - The user's prompt text
      * @returns The detected skill name
      */
     private detectSkill;
+    /**
+     * 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;
     /**
      * Gets the path to the conversation history file
      * @returns The path to the history file
@@ -29,26 +41,15 @@ export default class Copilot extends Command {
      * @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>;
+    /**
+     * Saves conversation history to file
+     * @param history - Array of conversation turns to save
+     */
+    private saveConversationHistory;
 }

package/dist/commands/copilot.js

@@ -13,13 +13,15 @@ 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 %> --file ./my-prompt.txt --model gpt-5.2',
         '<%= config.bin %> <%= command.id %> --prompt "Generate a new elixir for patient risk assessment" --skill elixir-generator',
+        '<%= config.bin %> <%= command.id %> --prompt "Complex task" --timeout 300  # Increase timeout for long-running requests',
         '<%= 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({
+            char: 'c',
             default: false,
             description: 'Clear conversation history and start a new session',
         }),
@@ -31,7 +33,12 @@ export default class Copilot extends Command {
         model: Flags.string({
             char: 'm',
             default: 'gpt-4.1',
-            description: 'Model to use for copilot-sdk interactions',
+            description: 'Model to use for copilot-sdk interactions. Supported models include: ' +
+                'GPT-4.1 (default), GPT-5.1, GPT-5.2, GPT-5.3, o1-mini, o3-mini, o4-mini, ' +
+                'Claude Haiku 4.5, Claude Opus 4.1/4.5/4.6, Claude Sonnet 3.5/3.7/4.5, ' +
+                'Gemini 2.0 Flash, Gemini 2.5 Pro, Gemini 3 Flash/Pro, Grok Code Fast 1, Raptor mini. ' +
+                'Model availability depends on your GitHub Copilot subscription. ' +
+                'See https://docs.github.com/en/copilot/reference/ai-models/supported-models for details.',
         }),
         prompt: Flags.string({
             char: 'p',
@@ -43,142 +50,13 @@ export default class Copilot extends Command {
             default: 'auto',
             description: 'Skill to use for copilot-sdk interactions (auto, start-dhti, elixir-generator, conch-generator)',
         }),
+        timeout: Flags.integer({
+            char: 't',
+            default: 180,
+            description: 'Timeout in seconds for model response (default: 180). Increase for complex prompts or slower models.',
+            min: 30,
+        }),
     };
-    /**
-     * 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';
-        }
-        // Use start-dhti if prompt includes 'start', 'show', or 'run'
-        if (lowerPrompt.includes('start') || lowerPrompt.includes('show') || lowerPrompt.includes('run')) {
-            return 'start-dhti';
-        }
-        // If none of the skills match, exit asking for a skill name and show available skills
-        const availableSkills = ['start-dhti', 'elixir-generator', 'conch-generator'];
-        this.error(`Could not detect the appropriate skill from the prompt.\n` +
-            `Please specify a skill name using --skill.\n` +
-            `Available skills: ${availableSkills.join(', ')}`);
-        return '';
-    }
-    /**
-     * 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
@@ -273,14 +151,33 @@ export default class Copilot extends Command {
                 process.stdout.write(content);
                 assistantResponse += content;
             });
-            // Handle session idle (response complete)
-            session.on('session.idle', () => {
-                if (responseStarted) {
-                    console.log('\n'); // Add newline after response
-                }
+            // Handle session errors
+            session.on('session.error', (error) => {
+                this.warn(chalk.yellow(`Session error: ${error}`));
+            });
+            // Send the prompt with a configurable timeout
+            const timeoutMs = flags.timeout * 1000;
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new Error(`Request timeout after ${timeoutMs}ms - increase with --timeout flag if needed`));
+                }, timeoutMs);
             });
-            // Send the prompt and wait for completion
-            await session.sendAndWait({ prompt: promptContent });
+            this.log(chalk.dim(`⏱  Timeout set to ${flags.timeout} seconds (use --timeout to adjust)`));
+            try {
+                await Promise.race([session.sendAndWait({ prompt: promptContent }), timeoutPromise]);
+            }
+            catch (timeoutError) {
+                if (assistantResponse.trim()) {
+                    this.log(chalk.yellow(`\n⚠ Response incomplete due to timeout, but partial response was captured.`));
+                    this.log(chalk.yellow(`💡 Tip: Try increasing timeout with --timeout ${flags.timeout * 2} for longer responses`));
+                }
+                else {
+                    throw timeoutError;
+                }
+            }
+            if (responseStarted) {
+                console.log('\n'); // Add newline after response
+            }
             this.log(chalk.blue('\n--- End of Response ---\n'));
             // Save conversation history
             conversationHistory.push({ content: promptContent, role: 'user' });
@@ -289,6 +186,7 @@ export default class Copilot extends Command {
             }
             this.saveConversationHistory(conversationHistory);
             this.log(chalk.dim(`💾 Conversation saved (${conversationHistory.length} messages). Use --clear-history to reset.`));
+            this.log(chalk.yellow('🧹 Cleaning up session, please wait...'));
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
@@ -305,4 +203,138 @@ export default class Copilot extends Command {
             }
         }
     }
+    /**
+     * 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}`));
+        }
+    }
+    /**
+     * 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';
+        }
+        // Use start-dhti if prompt includes 'start', 'show', or 'run'
+        if (lowerPrompt.includes('start') || lowerPrompt.includes('show') || lowerPrompt.includes('run')) {
+            return 'start-dhti';
+        }
+        // If none of the skills match, exit asking for a skill name and show available skills
+        const availableSkills = ['start-dhti', 'elixir-generator', 'conch-generator'];
+        this.error(`Could not detect the appropriate skill from the prompt.\n` +
+            `Please specify a skill name using --skill.\n` +
+            `Available skills: ${availableSkills.join(', ')}`);
+        return '';
+    }
+    /**
+     * 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;
+        }
+    }
+    /**
+     * 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 [];
+    }
+    /**
+     * 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);
+    }
+    /**
+     * 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}`));
+        }
+    }
 }

package/oclif.manifest.json

@@ -181,13 +181,15 @@
       "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 %> --file ./my-prompt.txt --model gpt-5.2",
         "<%= config.bin %> <%= command.id %> --prompt \"Generate a new elixir for patient risk assessment\" --skill elixir-generator",
+        "<%= config.bin %> <%= command.id %> --prompt \"Complex task\" --timeout 300  # Increase timeout for long-running requests",
         "<%= 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": {
+          "char": "c",
           "description": "Clear conversation history and start a new session",
           "name": "clear-history",
           "allowNo": false,
@@ -206,7 +208,7 @@
         },
         "model": {
           "char": "m",
-          "description": "Model to use for copilot-sdk interactions",
+          "description": "Model to use for copilot-sdk interactions. Supported models include: GPT-4.1 (default), GPT-5.1, GPT-5.2, GPT-5.3, o1-mini, o3-mini, o4-mini, Claude Haiku 4.5, Claude Opus 4.1/4.5/4.6, Claude Sonnet 3.5/3.7/4.5, Gemini 2.0 Flash, Gemini 2.5 Pro, Gemini 3 Flash/Pro, Grok Code Fast 1, Raptor mini. Model availability depends on your GitHub Copilot subscription. See https://docs.github.com/en/copilot/reference/ai-models/supported-models for details.",
           "name": "model",
           "default": "gpt-4.1",
           "hasDynamicHelp": false,
@@ -232,6 +234,15 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "timeout": {
+          "char": "t",
+          "description": "Timeout in seconds for model response (default: 180). Increase for complex prompts or slower models.",
+          "name": "timeout",
+          "default": 180,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -882,5 +893,5 @@
       ]
     }
   },
-  "version": "1.3.1"
+  "version": "1.3.3"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dhti-cli",
   "description": "DHTI CLI",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "author": "Bell Eapen",
   "bin": {
     "dhti-cli": "bin/run.js"