osagent-cli 0.1.12

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import './src/gemini.js';

package/dist/index.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import './src/gemini.js';
+import { main } from './src/gemini.js';
+import { FatalError } from 'osagent-core';
+// --- Global Entry Point ---
+main().catch((error) => {
+    if (error instanceof FatalError) {
+        let errorMessage = error.message;
+        if (!process.env['NO_COLOR']) {
+            errorMessage = `\x1b[31m${errorMessage}\x1b[0m`;
+        }
+        console.error(errorMessage);
+        process.exit(error.exitCode);
+    }
+    console.error('An unexpected critical error occurred:');
+    if (error instanceof Error) {
+        console.error(error.stack);
+    }
+    else {
+        console.error(String(error));
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,iBAAiB,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,6BAA6B;AAC7B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,IAAI,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,YAAY,GAAG,WAAW,YAAY,SAAS,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACxD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/package.json

@@ -0,0 +1,102 @@
+{
+    "name": "osagent-cli",
+    "version": "0.1.12",
+    "description": "OSAgent - AI Coding Assistant powered by Ollama",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/osagent/osagent-cli.git"
+    },
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "bin": {
+        "osagent": "dist/index.js"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        }
+    },
+    "scripts": {
+        "build": "node ../../scripts/build_package.js",
+        "start": "node dist/index.js",
+        "debug": "node --inspect-brk dist/index.js",
+        "lint": "eslint . --ext .ts,.tsx",
+        "format": "prettier --write .",
+        "test": "vitest run",
+        "test:ci": "vitest run",
+        "typecheck": "tsc --noEmit",
+        "check-i18n": "tsx ../../scripts/check-i18n.ts"
+    },
+    "files": [
+        "dist"
+    ],
+    "config": {
+        "sandboxImageUri": "ghcr.io/osagent/osagent:0.1.10"
+    },
+    "dependencies": {
+        "@google/genai": "1.16.0",
+        "@iarna/toml": "^2.2.5",
+        "@modelcontextprotocol/sdk": "^1.15.1",
+        "@types/update-notifier": "^6.0.8",
+        "ansi-regex": "^6.2.2",
+        "chalk": "^5.6.2",
+        "command-exists": "^1.2.9",
+        "comment-json": "^4.2.5",
+        "diff": "^7.0.0",
+        "dotenv": "^17.1.0",
+        "extract-zip": "^2.0.1",
+        "fzf": "^0.5.2",
+        "glob": "^10.4.5",
+        "gradient-string": "^2.0.2",
+        "highlight.js": "^11.11.1",
+        "ink": "^6.2.3",
+        "ink-gradient": "^3.0.0",
+        "ink-link": "^4.1.0",
+        "ink-spinner": "^5.0.0",
+        "lowlight": "^3.3.0",
+        "open": "^10.1.2",
+        "osagent-core": "file:../core",
+        "qrcode-terminal": "^0.12.0",
+        "react": "^19.1.0",
+        "read-package-up": "^11.0.0",
+        "shell-quote": "^1.8.3",
+        "simple-git": "^3.28.0",
+        "string-width": "^7.1.0",
+        "strip-ansi": "^7.1.0",
+        "strip-json-comments": "^3.1.1",
+        "tar": "^7.5.1",
+        "undici": "^7.10.0",
+        "update-notifier": "^7.3.1",
+        "wrap-ansi": "9.0.2",
+        "yargs": "^17.7.2",
+        "zod": "^3.23.8"
+    },
+    "devDependencies": {
+        "@babel/runtime": "^7.27.6",
+        "@testing-library/react": "^16.3.0",
+        "@types/archiver": "^6.0.3",
+        "@types/command-exists": "^1.2.3",
+        "@types/diff": "^7.0.2",
+        "@types/dotenv": "^6.1.1",
+        "@types/node": "^20.11.24",
+        "@types/react": "^19.1.8",
+        "@types/react-dom": "^19.1.6",
+        "@types/semver": "^7.7.0",
+        "@types/shell-quote": "^1.7.5",
+        "@types/tar": "^6.1.13",
+        "@types/yargs": "^17.0.32",
+        "archiver": "^7.0.1",
+        "ink-testing-library": "^4.0.0",
+        "jsdom": "^26.1.0",
+        "osagent-test-utils": "file:../test-utils",
+        "pretty-format": "^30.0.2",
+        "react-dom": "^19.1.0",
+        "typescript": "^5.3.3",
+        "vitest": "^3.1.1"
+    },
+    "engines": {
+        "node": ">=20"
+    }
+}

package/dist/src/commands/doctor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CommandModule } from 'yargs';
+export declare const doctorCommand: CommandModule;

package/dist/src/commands/doctor.js

@@ -0,0 +1,171 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+import { getCliVersion } from '../utils/version.js';
+const OSA_DIR = '.OSA';
+function checkNodeVersion() {
+    const version = process.version;
+    const major = parseInt(version.slice(1).split('.')[0], 10);
+    if (major >= 18) {
+        return { name: 'Node.js', status: 'ok', message: `${version} (supported)` };
+    }
+    else if (major >= 16) {
+        return {
+            name: 'Node.js',
+            status: 'warning',
+            message: `${version} (upgrade recommended)`,
+            action: 'Consider upgrading to Node.js 18 or higher'
+        };
+    }
+    return {
+        name: 'Node.js',
+        status: 'error',
+        message: `${version} (unsupported)`,
+        action: 'Please upgrade to Node.js 18 or higher'
+    };
+}
+function checkOllamaInstalled() {
+    try {
+        const result = execSync('ollama --version 2>&1', { encoding: 'utf-8', timeout: 5000 });
+        return { name: 'Ollama CLI', status: 'ok', message: result.trim() || 'installed' };
+    }
+    catch {
+        return {
+            name: 'Ollama CLI',
+            status: 'warning',
+            message: 'not found',
+            action: 'Install Ollama from https://ollama.com for local models'
+        };
+    }
+}
+function checkOllamaRunning() {
+    try {
+        execSync('curl -s http://localhost:11434/api/tags', { encoding: 'utf-8', timeout: 5000 });
+        return { name: 'Ollama Server', status: 'ok', message: 'running on localhost:11434' };
+    }
+    catch {
+        return {
+            name: 'Ollama Server',
+            status: 'warning',
+            message: 'not running',
+            action: 'Run "ollama serve" to start the local server'
+        };
+    }
+}
+function checkGlobalSettings() {
+    const settingsPath = path.join(homedir(), OSA_DIR, 'settings.json');
+    if (fs.existsSync(settingsPath)) {
+        try {
+            const content = fs.readFileSync(settingsPath, 'utf-8');
+            JSON.parse(content);
+            return { name: 'Global Settings', status: 'ok', message: settingsPath };
+        }
+        catch {
+            return {
+                name: 'Global Settings',
+                status: 'error',
+                message: 'invalid JSON',
+                action: `Fix JSON syntax in ${settingsPath}`
+            };
+        }
+    }
+    return {
+        name: 'Global Settings',
+        status: 'warning',
+        message: 'not found',
+        action: 'Run osagent to create default settings'
+    };
+}
+async function checkVersion() {
+    const currentVersion = await getCliVersion();
+    return { name: 'OSAgent Version', status: 'ok', message: `v${currentVersion}` };
+}
+async function checkLatestVersion() {
+    try {
+        const result = execSync('npm view osagent version 2>/dev/null', { encoding: 'utf-8', timeout: 10000 });
+        const latestVersion = result.trim();
+        const currentVersion = await getCliVersion();
+        if (currentVersion === latestVersion) {
+            return { name: 'Update Status', status: 'ok', message: 'up to date' };
+        }
+        return {
+            name: 'Update Status',
+            status: 'warning',
+            message: `update available (${latestVersion})`,
+            action: 'Run: sudo npm install -g osagent@latest'
+        };
+    }
+    catch {
+        return { name: 'Update Status', status: 'warning', message: 'could not check for updates' };
+    }
+}
+function checkEnvVars() {
+    const vars = ['OLLAMA_API_KEY', 'OPENAI_API_KEY'];
+    const found = vars.filter(v => process.env[v]);
+    if (found.length > 0) {
+        return { name: 'API Keys', status: 'ok', message: found.join(', ') + ' set' };
+    }
+    return {
+        name: 'API Keys',
+        status: 'warning',
+        message: 'no API keys in environment',
+        action: 'Set OLLAMA_API_KEY or configure in settings'
+    };
+}
+export const doctorCommand = {
+    command: 'doctor',
+    describe: 'Check system health and configuration',
+    handler: async () => {
+        console.log('\n🩺 OSAgent Doctor - System Diagnostics\n');
+        console.log('━'.repeat(50));
+        const checks = [
+            await checkVersion(),
+            await checkLatestVersion(),
+            checkNodeVersion(),
+            checkOllamaInstalled(),
+            checkOllamaRunning(),
+            checkGlobalSettings(),
+            checkEnvVars(),
+        ];
+        let hasErrors = false;
+        let hasWarnings = false;
+        const actions = [];
+        for (const check of checks) {
+            const icon = check.status === 'ok' ? '✓' : check.status === 'warning' ? '!' : '✗';
+            const color = check.status === 'ok' ? '\x1b[32m' : check.status === 'warning' ? '\x1b[33m' : '\x1b[31m';
+            const reset = '\x1b[0m';
+            console.log(`${color}${icon}${reset} ${check.name.padEnd(20)} ${check.message}`);
+            if (check.status === 'error')
+                hasErrors = true;
+            if (check.status === 'warning')
+                hasWarnings = true;
+            if (check.action)
+                actions.push(check.action);
+        }
+        console.log('━'.repeat(50));
+        if (actions.length > 0) {
+            console.log('\n📋 Recommended Actions:\n');
+            actions.forEach((action, i) => {
+                console.log(`   ${i + 1}. ${action}`);
+            });
+        }
+        if (hasErrors) {
+            console.log('\n\x1b[31m❌ Some checks failed. Please fix the errors above.\x1b[0m\n');
+            process.exit(1);
+        }
+        else if (hasWarnings) {
+            console.log('\n\x1b[33m⚠️  Some warnings found. OSAgent should work but consider the recommendations.\x1b[0m\n');
+        }
+        else {
+            console.log('\n\x1b[32m✅ All checks passed! OSAgent is ready to use.\x1b[0m\n');
+        }
+        console.log('Run \x1b[36mosagent\x1b[0m to start the interactive assistant.\n');
+    },
+};
+//# sourceMappingURL=doctor.js.map

package/dist/src/commands/doctor.js.map

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

package/dist/src/commands/extensions/disable.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type CommandModule } from 'yargs';
+interface DisableArgs {
+    name: string;
+    scope?: string;
+}
+export declare function handleDisable(args: DisableArgs): void;
+export declare const disableCommand: CommandModule;
+export {};

package/dist/src/commands/extensions/disable.js

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {} from 'yargs';
+import { disableExtension } from '../../config/extension.js';
+import { SettingScope } from '../../config/settings.js';
+import { getErrorMessage } from '../../utils/errors.js';
+export function handleDisable(args) {
+    try {
+        if (args.scope?.toLowerCase() === 'workspace') {
+            disableExtension(args.name, SettingScope.Workspace);
+        }
+        else {
+            disableExtension(args.name, SettingScope.User);
+        }
+        console.log(`Extension "${args.name}" successfully disabled for scope "${args.scope}".`);
+    }
+    catch (error) {
+        console.error(getErrorMessage(error));
+        process.exit(1);
+    }
+}
+export const disableCommand = {
+    command: 'disable [--scope] <name>',
+    describe: 'Disables an extension.',
+    builder: (yargs) => yargs
+        .positional('name', {
+        describe: 'The name of the extension to disable.',
+        type: 'string',
+    })
+        .option('scope', {
+        describe: 'The scope to disable the extenison in.',
+        type: 'string',
+        default: SettingScope.User,
+    })
+        .check((argv) => {
+        if (argv['scope'] &&
+            !Object.values(SettingScope)
+                .map((s) => s.toLowerCase())
+                .includes(argv['scope'].toLowerCase())) {
+            throw new Error(`Invalid scope: ${argv['scope']}. Please use one of ${Object.values(SettingScope)
+                .map((s) => s.toLowerCase())
+                .join(', ')}.`);
+        }
+        return true;
+    }),
+    handler: (argv) => {
+        handleDisable({
+            name: argv['name'],
+            scope: argv['scope'],
+        });
+    },
+};
+//# sourceMappingURL=disable.js.map

package/dist/src/commands/extensions/disable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.js","sourceRoot":"","sources":["../../../../src/commands/extensions/disable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0D,MAAM,OAAO,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAOxD,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;YAC9C,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,GAAG,CACT,cAAc,IAAI,CAAC,IAAI,sCAAsC,IAAI,CAAC,KAAK,IAAI,CAC5E,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,OAAO,EAAE,0BAA0B;IACnC,QAAQ,EAAE,wBAAwB;IAClC,OAAO,EAAE,CAAC,KAAW,EAAE,EAAE,CACvB,KAAK;SACF,UAAU,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,uCAAuC;QACjD,IAAI,EAAE,QAAQ;KACf,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,QAAQ,EAAE,wCAAwC;QAClD,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,YAAY,CAAC,IAAI;KAC3B,CAAC;SACD,KAAK,CAAC,CAAC,IAAwB,EAAE,EAAE;QAClC,IACE,IAAI,CAAC,OAAO,CAAC;YACb,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;iBACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;iBAC3B,QAAQ,CAAE,IAAI,CAAC,OAAO,CAAY,CAAC,WAAW,EAAE,CAAC,EACpD,CAAC;YACD,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,CAAC,OAAO,CAAC,uBAAuB,MAAM,CAAC,MAAM,CACjE,YAAY,CACb;iBACE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;iBAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CACjB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACN,OAAO,EAAE,CAAC,IAAwB,EAAE,EAAE;QACpC,aAAa,CAAC;YACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAW;YAC5B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAW;SAC/B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/src/commands/extensions/enable.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type CommandModule } from 'yargs';
+interface EnableArgs {
+    name: string;
+    scope?: string;
+}
+export declare function handleEnable(args: EnableArgs): void;
+export declare const enableCommand: CommandModule;
+export {};

package/dist/src/commands/extensions/enable.js

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {} from 'yargs';
+import { FatalConfigError, getErrorMessage } from 'osagent-core';
+import { enableExtension } from '../../config/extension.js';
+import { SettingScope } from '../../config/settings.js';
+export function handleEnable(args) {
+    try {
+        if (args.scope?.toLowerCase() === 'workspace') {
+            enableExtension(args.name, SettingScope.Workspace);
+        }
+        else {
+            enableExtension(args.name, SettingScope.User);
+        }
+        if (args.scope) {
+            console.log(`Extension "${args.name}" successfully enabled for scope "${args.scope}".`);
+        }
+        else {
+            console.log(`Extension "${args.name}" successfully enabled in all scopes.`);
+        }
+    }
+    catch (error) {
+        throw new FatalConfigError(getErrorMessage(error));
+    }
+}
+export const enableCommand = {
+    command: 'enable [--scope] <name>',
+    describe: 'Enables an extension.',
+    builder: (yargs) => yargs
+        .positional('name', {
+        describe: 'The name of the extension to enable.',
+        type: 'string',
+    })
+        .option('scope', {
+        describe: 'The scope to enable the extenison in. If not set, will be enabled in all scopes.',
+        type: 'string',
+    })
+        .check((argv) => {
+        if (argv['scope'] &&
+            !Object.values(SettingScope)
+                .map((s) => s.toLowerCase())
+                .includes(argv['scope'].toLowerCase())) {
+            throw new Error(`Invalid scope: ${argv['scope']}. Please use one of ${Object.values(SettingScope)
+                .map((s) => s.toLowerCase())
+                .join(', ')}.`);
+        }
+        return true;
+    }),
+    handler: (argv) => {
+        handleEnable({
+            name: argv['name'],
+            scope: argv['scope'],
+        });
+    },
+};
+//# sourceMappingURL=enable.js.map

package/dist/src/commands/extensions/enable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.js","sourceRoot":"","sources":["../../../../src/commands/extensions/enable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0D,MAAM,OAAO,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAOxD,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;YAC9C,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CACT,cAAc,IAAI,CAAC,IAAI,qCAAqC,IAAI,CAAC,KAAK,IAAI,CAC3E,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CACT,cAAc,IAAI,CAAC,IAAI,uCAAuC,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,gBAAgB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,OAAO,EAAE,yBAAyB;IAClC,QAAQ,EAAE,uBAAuB;IACjC,OAAO,EAAE,CAAC,KAAW,EAAE,EAAE,CACvB,KAAK;SACF,UAAU,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,sCAAsC;QAChD,IAAI,EAAE,QAAQ;KACf,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,QAAQ,EACN,kFAAkF;QACpF,IAAI,EAAE,QAAQ;KACf,CAAC;SACD,KAAK,CAAC,CAAC,IAAwB,EAAE,EAAE;QAClC,IACE,IAAI,CAAC,OAAO,CAAC;YACb,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;iBACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;iBAC3B,QAAQ,CAAE,IAAI,CAAC,OAAO,CAAY,CAAC,WAAW,EAAE,CAAC,EACpD,CAAC;YACD,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,CAAC,OAAO,CAAC,uBAAuB,MAAM,CAAC,MAAM,CACjE,YAAY,CACb;iBACE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;iBAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CACjB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACN,OAAO,EAAE,CAAC,IAAwB,EAAE,EAAE;QACpC,YAAY,CAAC;YACX,IAAI,EAAE,IAAI,CAAC,MAAM,CAAW;YAC5B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAW;SAC/B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/src/commands/extensions/examples/context/QWEN.md

@@ -0,0 +1,8 @@
+# Ink Library Screen Reader Guidance
+
+When building custom components, it's important to keep accessibility in mind. While Ink provides the building blocks, ensuring your components are accessible will make your CLIs usable by a wider audience.
+
+## General Principles
+
+Provide screen reader-friendly output: Use the useIsScreenReaderEnabled hook to detect if a screen reader is active. You can then render a more descriptive output for screen reader users.
+Leverage ARIA props: For components that have a specific role (e.g., a checkbox or a button), use the aria-role, aria-state, and aria-label props on <Box> and <Text> to provide semantic meaning to screen readers.

package/dist/src/commands/extensions/examples/context/qwen-extension.json

@@ -0,0 +1,4 @@
+{
+  "name": "context-example",
+  "version": "1.0.0"
+}

package/dist/src/commands/extensions/examples/custom-commands/commands/fs/grep-code.toml

@@ -0,0 +1,6 @@
+prompt = """
+Please summarize the findings for the pattern `{{args}}`.
+
+Search Results:
+!{grep -r {{args}} .}
+"""

package/dist/src/commands/extensions/examples/custom-commands/qwen-extension.json

@@ -0,0 +1,4 @@
+{
+  "name": "custom-commands",
+  "version": "1.0.0"
+}

package/dist/src/commands/extensions/examples/exclude-tools/qwen-extension.json

@@ -0,0 +1,5 @@
+{
+  "name": "excludeTools",
+  "version": "1.0.0",
+  "excludeTools": ["run_shell_command(rm -rf)"]
+}

package/dist/src/commands/extensions/examples/mcp-server/example.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const server = new McpServer({
+  name: 'prompt-server',
+  version: '1.0.0',
+});
+
+server.registerTool(
+  'fetch_posts',
+  {
+    description: 'Fetches a list of posts from a public API.',
+    inputSchema: z.object({}).shape,
+  },
+  async () => {
+    const apiResponse = await fetch(
+      'https://jsonplaceholder.typicode.com/posts',
+    );
+    const posts = await apiResponse.json();
+    const response = { posts: posts.slice(0, 5) };
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(response),
+        },
+      ],
+    };
+  },
+);
+
+server.registerPrompt(
+  'poem-writer',
+  {
+    title: 'Poem Writer',
+    description: 'Write a nice haiku',
+    argsSchema: { title: z.string(), mood: z.string().optional() },
+  },
+  ({ title, mood }) => ({
+    messages: [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Write a haiku${mood ? ` with the mood ${mood}` : ''} called ${title}. Note that a haiku is 5 syllables followed by 7 syllables followed by 5 syllables `,
+        },
+      },
+    ],
+  }),
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/src/commands/extensions/examples/mcp-server/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "mcp-server-example",
+  "version": "1.0.0",
+  "description": "Example MCP Server for OSA CLI Extension",
+  "type": "module",
+  "main": "example.js",
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "~5.4.5",
+    "@types/node": "^20.11.25"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0",
+    "zod": "^3.22.4"
+  }
+}

package/dist/src/commands/extensions/examples/mcp-server/qwen-extension.json

@@ -0,0 +1,11 @@
+{
+  "name": "mcp-server-example",
+  "version": "1.0.0",
+  "mcpServers": {
+    "nodeServer": {
+      "command": "node",
+      "args": ["${extensionPath}${/}dist${/}example.js"],
+      "cwd": "${extensionPath}"
+    }
+  }
+}

package/dist/src/commands/extensions/examples/mcp-server/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist"
+  },
+  "include": ["example.ts"]
+}

package/dist/src/commands/extensions/install.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 OSAgent OC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CommandModule } from 'yargs';
+interface InstallArgs {
+    source: string;
+    ref?: string;
+    autoUpdate?: boolean;
+}
+export declare function handleInstall(args: InstallArgs): Promise<void>;
+export declare const installCommand: CommandModule;
+export {};